Previous | Next |
The GetDCStatus method retrieves the control status of the device.
Syntax
HRESULT GetDCStatus(
DWORD* pdwStatus
);
Parameters
pdwStatus
[out] Pointer to a double word that contains the control status of the device. The control status value contains one or more of the following flags.
Flag | Description |
WMDM_STATUS_READY | Windows Media Device Manager and its subcomponents are in a ready state. |
WMDM_STATUS_BUSY | An operation is currently being performed. Evaluate the other status values to determine which operation it is. |
WMDM_STATUS_DEVICECONTROL_PLAYING | The device is currently playing. |
WMDM_STATUS_DEVICECONTROL_RECORDING | The device is currently recording. |
WMDM_STATUS_DEVICECONTROL_PAUSED | The device is currently paused. |
WMDM_STATUS_DEVICECONTROL_REMOTE | The play or record operation of the device is being remotely controlled by the application. |
WMDM_STATUS_DEVICECONTROL_STREAM | The play or record method is streaming data to or from the media device. |
Return Values
If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.
Return code | Description |
E_INVALIDARG | The pdwStatus parameter is an invalid or NULL pointer. |
E_FAIL | An unspecified error occurred. |
Remarks
This call returns status values specific to the device control operations of this interface. The control status can provide information about the state of control-related activities of the device, such as playing, recording, and so on. However, it cannot provide information about the global status of the device, such as whether the device is downloading data or being accessed for some other reason. If the device is busy for any reason other than device control, you receive a busy code and must call the GetStatus method of the associated IMDSPDevice interface for more detailed information.
You must not attempt to call the Play, Record, Pause, Resume, or Stop methods of this interface if the status value WMDM_STATUS_BUSY is returned and the status value does not contain any other values from the table of status values.
See Also
Previous | Next |