Método IWMDMDeviceControl::GetStatus (mswmdm.h)
O método GetStatus recupera o controle status do dispositivo.
Sintaxe
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
Parâmetros
[out] pdwStatus
Ponteiro para um DWORD que especifica o controle status do dispositivo. O controle status valor especifica um ou mais dos sinalizadores a seguir.
| Sinalizador | Descrição |
|---|---|
| WMDM_STATUS_READY | Os Gerenciador de Dispositivos do Windows Media e seus subcomponentes estão em um estado pronto. |
| WMDM_STATUS_BUSY | Uma operação está sendo executada no momento. Avalie os outros valores de status para determinar qual operação é. |
| WMDM_STATUS_DEVICECONTROL_PLAYING | No momento, o dispositivo está sendo reproduzido. |
| WMDM_STATUS_DEVICECONTROL_RECORDING | O dispositivo está sendo gravado no momento. |
| WMDM_STATUS_DEVICECONTROL_PAUSED | No momento, o dispositivo está em pausa. |
| WMDM_STATUS_DEVICECONTROL_REMOTE | A operação de reprodução ou registro do dispositivo está sendo controlada remotamente pelo aplicativo. |
| WMDM_STATUS_DEVICECONTROL_STREAM | O método de reprodução ou gravação é transmitir dados de ou para o dispositivo de mídia. |
Retornar valor
O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
O parâmetro pdwStatus é um ponteiro NULL ou inválido. |
|
Ocorreu um erro não especificado. |
Comentários
Essa chamada retorna status valores específicos para as operações de controle de dispositivo dessa interface. O controle status pode fornecer informações sobre o estado das atividades relacionadas ao controle do dispositivo, como reprodução, gravação e assim por diante. No entanto, ele não pode fornecer informações sobre o status global do dispositivo, como se o dispositivo está baixando dados ou sendo acessado por algum outro motivo. Se o dispositivo estiver ocupado por qualquer motivo diferente do controle do dispositivo, você receberá um código ocupado e deverá chamar o método IWMDMDeviceControl::GetStatus para obter informações mais detalhadas.
Você não deve tentar chamar os métodos Reproduzir, Gravar, Pausar, Retomar ou Parar dessa interface se o valor status WMDM_STATUS_BUSY for retornado e o valor status não contiver nenhum outro valor da tabela de valores status.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | mswmdm.h |
| Biblioteca | Mssachlp.lib |