Compartilhar via


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

O método Initialize formata o meio de armazenamento.

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 retornará 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.

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

Se um aplicativo usa WMDM_MODE_THREAD e passa um parâmetro pProgress não nulo, o aplicativo deve garantir que o objeto ao qual pProgress pertence não seja destruído até que a operação de leitura seja concluída, pois o Windows Media Gerenciador de Dispositivos enviará notificações de progresso para esse objeto. Esse objeto só pode ser destruído depois de receber uma notificação end . A falha ao fazer isso resultará em violações de acesso.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho mswmdm.h
Biblioteca Mssachlp.lib

Confira também

IWMDMProgress Interface

IWMDMStorageGlobals Interface