Compartilhar via

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

  • Artigo

O método GetStatus recupera a status atual do meio de armazenamento.

Sintaxe

HRESULT GetStatus(
  [out] DWORD *pdwStatus
);

Parâmetros

[out] pdwStatus

Ponteiro para um DWORD que contém as informações de status. Os valores de status a seguir podem ser retornados pelo parâmetro pdwStatus.

Status Descrição
WMDM_STATUS_READY O meio está em um estado pronto ocioso.
WMDM_STATUS_BUSY Uma operação está em andamento. Avalie status valores para determinar a operação em andamento.
WMDM_STATUS_STORAGE_NOTPRESENT O meio não está presente. Para dispositivos que dão suporte a mais de um meio, esse valor só é relatado da interface IMDSPStorageGlobals .
WMDM_STATUS_STORAGE_INITIALIZING No momento, o dispositivo está ocupado formatando mídia em um dispositivo.
WMDM_STATUS_STORAGE_BROKEN O meio está quebrado. Para dispositivos que dão suporte a mais de um meio, esse valor só é relatado da interface IMDSPStorageGlobals .
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 só é retornado da interface IMDSPStorageGlobals .
WMDM_STATUS_STORAGE_UNFORMATTED O meio não está formatado. Para dispositivos que dão suporte a mais de um meio, esse valor só é relatado da interface IMDSPStorageGlobals .

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 de Gerenciador de Dispositivos do Windows Media
Para obter uma ampla lista de possíveis códigos de erro, consulte Códigos de erro.

Comentários

Você sempre deve chamar esse método antes de tentar interagir com um meio de armazenamento. O valor status retornado será WMDM_STATUS_BUSY se alguma outra interface tiver invocado uma operação em andamento. Você pode avaliar o valor retornado dessa chamada para determinar se uma operação em andamento foi invocada da interface IMDSPStorageGlobals .

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

Confira também

IMDSPStorageGlobals Interface