IMDSPStorageGlobals::Initialize-Methode (mswmdm.h)

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.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

IMDSPStorageGlobals-Schnittstelle

IMDSPStorageGlobals::GetCapabilities

IMDSPStorageGlobals::GetStatus

IWMDMProgress-Schnittstelle