Método IMDSPDevice::GetStatus (mswmdm.h)

Artigo
08/25/2023

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

Para obter uma lista abrangente de possíveis códigos de erro, consulte Códigos de erro.

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.