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

Artigo
08/25/2023

O método Initialize formata o meio de armazenamento. Esse método é opcional. No entanto, esse método deverá ser implementado se o dispositivo der suporte a essa funcionalidade. Se esse método não for implementado, IMDSPStorageGlobals::GetCapabilities deverá retornar WMDM_STORAGECAP_NOT_INITIALIZABLE além de outros sinalizadores. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.

Sintaxe

HRESULT Initialize(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress
);

Parâmetros

[in] fuMode

Modo usado para inicializar o meio. Especifique exatamente um dos dois modos a seguir. Se ambos os modos forem especificados, o modo de bloco será usado.

Mode	Descrição
WMDM_MODE_BLOCK	A operação é executada usando o processamento do modo de bloco. A chamada não será retornada até que a operação seja concluída.
WMDM_MODE_THREAD	A operação é executada usando o processamento do modo thread. A chamada retorna imediatamente e a operação é executada em um thread em segundo plano.

[in] pProgress

Ponteiro para uma interface IWMDMProgress implementada por um aplicativo para acompanhar o progresso da operação de formatação. Este parâmetro pode ser NULL.

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

Se WMDM_MODE_BLOCK for especificado, Initialize não retornará até que a formatação seja concluída. Se o WMDM_MODE_THREAD for especificado, a chamada retornará imediatamente e o chamador poderá usar o método IMDSPStorageGlobals::GetStatus para acompanhar a operação de inicialização.