Método IMDSPDeviceControl::GetDCStatus (mswmdm.h)

El método GetDCStatus recupera el estado de control del dispositivo.

Sintaxis

HRESULT GetDCStatus(
  [out] DWORD *pdwStatus
);

Parámetros

[out] pdwStatus

Puntero a un DWORD que contiene el estado de control del dispositivo. El valor de estado del control contiene una o varias de las marcas siguientes.

Marca	Descripción
WMDM_STATUS_READY	Windows Media Administrador de dispositivos y sus subcomponentes están en un estado listo.
WMDM_STATUS_BUSY	Actualmente se está realizando una operación. Evalúe los demás valores de estado para determinar qué operación es.
WMDM_STATUS_DEVICECONTROL_PLAYING	El dispositivo está reproduciendo actualmente.
WMDM_STATUS_DEVICECONTROL_RECORDING	El dispositivo está grabando actualmente.
WMDM_STATUS_DEVICECONTROL_PAUSED	El dispositivo está actualmente en pausa.
WMDM_STATUS_DEVICECONTROL_REMOTE	La aplicación controla de forma remota la operación de reproducción o registro del dispositivo.
WMDM_STATUS_DEVICECONTROL_STREAM	El método de reproducción o registro es transmitir datos hacia o desde el dispositivo multimedia.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_INVALIDARG	El parámetro pdwStatus es un puntero null o no válido.
E_FAIL	Se ha producido un error no especificado.

Comentarios

Esta llamada devuelve valores de estado específicos de las operaciones de control de dispositivo de esta interfaz. El estado del control puede proporcionar información sobre el estado de las actividades relacionadas con el control del dispositivo, como reproducir, grabar, etc. Sin embargo, no puede proporcionar información sobre el estado global del dispositivo, como si el dispositivo está descargando datos o accediendo por algún otro motivo. Si el dispositivo está ocupado por cualquier motivo distinto del control de dispositivo, recibe un código ocupado y debe llamar al método GetStatus de la interfaz IMDSPDevice asociada para obtener información más detallada.

No debe intentar llamar a los métodos Play, Record, Pause, Resume o Stop de esta interfaz si se devuelve el valor de estado WMDM_STATUS_BUSY y el valor de estado no contiene ningún otro valor de la tabla de valores de estado.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	mswmdm.h
Library	Mssachlp.lib

Consulte también

Interfaz IMDSPDeviceControl