Método IMDSPDevice::GetStatus (mswmdm.h)
O método GetStatus recupera todas as informações de status do dispositivo que o dispositivo pode fornecer.
Sintaxe
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
Parâmetros
[out] pdwStatus
Ponteiro para um DWORD que recebe o dispositivo atual status. Esses valores status são definidos na tabela a seguir.
Status | Descrição |
---|---|
WMDM_STATUS_READY | O Windows Media Gerenciador de Dispositivos e seus subcomponentes estão em um estado pronto. |
WMDM_STATUS_BUSY | Uma operação está em andamento. Verifique outros valores de status para determinar qual operação é. |
WMDM_STATUS_DEVICE_NOTPRESENT | O dispositivo não está conectado ao computador. |
WMDM_STATUS_STORAGE_NOTPRESENT | O meio não está presente. Para dispositivos que dão suporte a mais de um meio, esse valor é relatado somente da interface IWMDMStorageGlobals . |
WMDM_STATUS_STORAGE_INITIALIZING | No momento, o dispositivo está ocupado formatando mídia no dispositivo. |
WMDM_STATUS_STORAGE_BROKEN | O meio não está funcionando. Para dispositivos que dão suporte a mais de um meio, esse valor é relatado somente da interface IWMDMStorageGlobals . |
WMDM_STATUS_STORAGE_NOTSUPPORTED | O meio não é compatível com o dispositivo. Para dispositivos que dão suporte a mais de um meio, esse valor é retornado somente da interface IWMDMStorageGlobals . |
WMDM_STATUS_STORAGE_UNFORMATTED | O meio não está formatado. Para dispositivos que dão suporte a mais de um meio, esse valor é retornado somente da interface IWMDMStorageGlobals . |
WMDM_STATUS_STORAGECONTROL_INSERTING | O método IWMDMStorageControl::Insert está em execução no momento. |
WMDM_STATUS_STORAGECONTROL_DELETING | O método IWMDMStorageControl::D elete está em execução no momento. |
WMDM_STATUS_STORAGECONTROL_MOVING | O método IWMDMStorageControl::Move está em execução no momento. |
WMDM_STATUS_STORAGECONTROL_READING | O método IWMDMStorageControl::Read está em execução no momento. |
Retornar valor
O método retorna um HRESULT. Todos os métodos de interface no Windows Media Gerenciador de Dispositivos podem retornar qualquer uma das seguintes classes de códigos de erro:
- Códigos de erro COM padrão
- Códigos de erro do Windows convertidos em valores HRESULT
- Códigos de erro do Windows Media Gerenciador de Dispositivos
Comentários
Um ou mais valores de status podem ser retornados dessa chamada. Todos os valores de status de todas as interfaces do dispositivo de mídia são relatados por meio dessa chamada. Por exemplo, se uma operação de armazenamento, como gravar um arquivo em um dispositivo de mídia estiver em andamento, uma chamada para esse método relatará o status ocupado dessa operação. Para qualquer operação em andamento, o valor status WMDM_STATUS_BUSY está sempre presente.
Esse método deve ser implementado. Ele não deve retornar WMDM_E_NOTSUPPORTED ou E_NOTIMPL. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Windows |
Cabeçalho | mswmdm.h |
Biblioteca | Mssachlp.lib |