Compartilhar via

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

  • Artigo

O método GetDCStatus recupera o controle status do dispositivo.

Sintaxe

HRESULT GetDCStatus(
  [out] DWORD *pdwStatus
);

Parâmetros

[out] pdwStatus

Ponteiro para um DWORD que contém o controle status do dispositivo. O controle status valor contém 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
S_OK
 O método foi bem-sucedido.
E_INVALIDARG
 O parâmetro pdwStatus é um ponteiro NULL ou inválido.
E_FAIL
 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 GetStatus da interface IMDSPDevice associada 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

Confira também

IMDSPDeviceControl Interface