IMDSPStorageGlobals::Initialize-Methode (mswmdm.h)

Artikel
02/29/2024

Die Initialize-Methode formatiert das Speichermedium. Diese Methode ist optional. Diese Methode sollte jedoch implementiert werden, wenn das Gerät diese Funktionalität unterstützt. Wenn diese Methode nicht implementiert ist, muss IMDSPStorageGlobals::GetCapabilities zusätzlich zu allen anderen Flags WMDM_STORAGECAP_NOT_INITIALIZABLE zurückgeben. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.

Syntax

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

Parameter

[in] fuMode

Der Modus, der zum Initialisieren des Mediums verwendet wird. Geben Sie genau einen der folgenden beiden Modi an. Wenn beide Modi angegeben sind, wird der Blockmodus verwendet.

Mode	BESCHREIBUNG
WMDM_MODE_BLOCK	Der Vorgang wird mithilfe der Blockmodusverarbeitung ausgeführt. Der Aufruf wird erst zurückgegeben, wenn der Vorgang abgeschlossen ist.
WMDM_MODE_THREAD	Der Vorgang wird im Threadmodus verarbeitet. Der Aufruf wird sofort zurückgegeben, und der Vorgang wird in einem Hintergrundthread ausgeführt.

[in] pProgress

Zeiger auf eine IWMDMProgress-Schnittstelle , die von einer Anwendung implementiert wird, um den Fortschritt des Formatierungsvorgangs nachzuverfolgen. Dieser Parameter kann NULL sein.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

Standard-COM-Fehlercodes
In HRESULT-Werte konvertierte Windows-Fehlercodes
Windows Media Geräte-Manager Fehlercodes

Eine umfassende Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Wenn WMDM_MODE_BLOCK angegeben ist, wird Initialize erst zurückgegeben, wenn die Formatierung abgeschlossen ist. Wenn die WMDM_MODE_THREAD angegeben ist, wird der Aufruf sofort zurückgegeben, und der Aufrufer kann die IMDSPStorageGlobals::GetStatus-Methode verwenden, um den Initialisierungsvorgang nachzuverfolgen.