MCI_GETDEVCAPS Return Value - rc

rc (ULONG)

The low-order word of rc contains a code indicating success or failure:

/* Only examine the low-order word of the return code for */
/*success/failure */
if ( (ulError & 0x0000FFFF) == MCIERR_SUCCESS )

The format of the ulReturn value in the MCI_GETDEVCAPS_PARMS structure is defined by the high-order word of the value returned by mciSendCommand. This value is used by mciSendString to determine how to convert the ulReturn value to string form. For a list of the possible format values, see the MMDRVOS2.H header file.

Return codes indicating success or type of failure:

MCIERR_SUCCESS

MMPM/2 command completed successfully.
MCIERR_DRIVER
Internal MMPM/2 driver error.
MCIERR_FLAGS_NOT_COMPATIBLE
The flags cannot be used together.
MCIERR_INVALID_CONNECTOR_TYPE
Invalid connector type given.
MCIERR_INVALID_DEVICE_ID
Invalid device ID given.
MCIERR_INVALID_FLAG
Invalid flag specified for this command.
MCIERR_INVALID_ITEM_FLAG
Invalid item flag specified for this command.
MCIERR_MISSING_FLAG
Flag missing for this MMPM/2 command.
MCIERR_MISSING_PARAMETER
Missing parameter for this command.
MCIERR_OUT_OF_MEMORY
System out of memory.
MCIERR_UNSUPPORTED_CONN_TYPE
Connector type is not supported by this device.
MCIERR_UNSUPP_CHANNELS
The hardware does not support this channel setting.
MCIERR_UNSUPP_BITSPERSAMPLE
The hardware does not support this bits per sample setting.
MCIERR_UNSUPP_FORMAT_MODE
The hardware does not support this format mode.
MCIERR_UNSUPP_FORMAT_TAG
The hardware does not support this format tag.
MCIERR_UNSUPP_SAMPLESPERSEC
The hardware does not support this sampling rate.
MCIERR_UNSUPPORTED_ATTRIBUTE
Current mixer hardware does not support the attribute.
MCIERR_UNSUPPORTED_FLAG
Given flag is unsupported for this device.

---

[Back: MCI_GETDEVCAPS Parameter - pParam2]
[Next: MCI_GETDEVCAPS - Description]