MÉTHODE IMDSPStorageGlobals ::Initialize (mswmdm.h)

Article
02/29/2024

La méthode Initialize met en forme le support de stockage. Cette méthode est facultative. Toutefois, cette méthode doit être implémentée si l’appareil prend en charge cette fonctionnalité. Si cette méthode n’est pas implémentée, IMDSPStorageGlobals ::GetCapabilities doit retourner WMDM_STORAGECAP_NOT_INITIALIZABLE en plus des autres indicateurs. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.

Syntaxe

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

Paramètres

[in] fuMode

Mode utilisé pour initialiser le support. Spécifiez exactement l’un des deux modes suivants. Si les deux modes sont spécifiés, le mode bloc est utilisé.

Mode	Description
WMDM_MODE_BLOCK	L’opération est effectuée à l’aide du traitement en mode bloc. L’appel n’est pas retourné tant que l’opération n’est pas terminée.
WMDM_MODE_THREAD	L’opération est effectuée à l’aide du traitement en mode thread. L’appel retourne immédiatement et l’opération est effectuée dans un thread d’arrière-plan.

[in] pProgress

Pointeur vers une interface IWMDMProgress implémentée par une application pour suivre la progression de l’opération de mise en forme. Ce paramètre peut être NULL.

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes suivantes de codes d’erreur :

Codes d’erreur COM standard
Codes d’erreur Windows convertis en valeurs HRESULT
Codes d’erreur Gestionnaire de périphériques Windows Media

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Si WMDM_MODE_BLOCK est spécifié, Initialize ne retourne pas tant que la mise en forme n’est pas terminée. Si le WMDM_MODE_THREAD est spécifié, l’appel est retourné immédiatement et l’appelant peut utiliser la méthode IMDSPStorageGlobals ::GetStatus pour suivre l’opération d’initialisation.