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

Artículo
03/15/2023

El método Initialize da formato al medio de almacenamiento. Este método es opcional. Sin embargo, este método se debe implementar si el dispositivo admite esta funcionalidad. Si no se implementa este método, IMDSPStorageGlobals::GetCapabilities debe devolver WMDM_STORAGECAP_NOT_INITIALIZABLE además de cualquier otra marca. Para obtener más información, consulte Interfaces obligatorias y opcionales.

Sintaxis

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

Parámetros

[in] fuMode

Modo usado para inicializar el medio. Especifique exactamente uno de los dos modos siguientes. Si se especifican ambos modos, se usa el modo de bloque.

Mode	Descripción
WMDM_MODE_BLOCK	La operación se realiza mediante el procesamiento del modo de bloque. La llamada no se devuelve hasta que finalice la operación.
WMDM_MODE_THREAD	La operación se realiza mediante el procesamiento del modo de subproceso. La llamada devuelve inmediatamente y la operación se realiza en un subproceso en segundo plano.

[in] pProgress

Puntero a una interfaz IWMDMProgress implementada por una aplicación para realizar un seguimiento del progreso de la operación de formato. Este parámetro puede ser NULL.

Valor devuelto

El método devuelve un valor HRESULT. Todos los métodos de interfaz de Windows Media Administrador de dispositivos pueden devolver cualquiera de las siguientes clases de códigos de error:

Códigos de error COM estándar
Códigos de error de Windows convertidos en valores HRESULT
Códigos de error de windows Media Administrador de dispositivos

Para obtener una lista extensa de posibles códigos de error, consulte Códigos de error.

Comentarios

Si se especifica WMDM_MODE_BLOCK, Initialize no devuelve hasta que finalice el formato. Si se especifica el WMDM_MODE_THREAD, la llamada devuelve inmediatamente y el autor de la llamada puede usar el método IMDSPStorageGlobals::GetStatus para realizar un seguimiento de la operación de inicialización.