IMDSPStorageGlobals::Initialize メソッド (mswmdm.h)

[アーティクル]
03/13/2024

Initialize メソッドは、ストレージメディアの書式を設定します。このメソッドは省略可能です。ただし、デバイスがこの機能をサポートしている場合は、このメソッドを実装する必要があります。このメソッドが実装されていない場合、 IMDSPStorageGlobals::GetCapabilities は他のフラグに加えてWMDM_STORAGECAP_NOT_INITIALIZABLEを返す必要があります。詳細については、「必須インターフェイスとオプションインターフェイス」を参照してください。

構文

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

パラメーター

[in] fuMode

メディアの初期化に使用されるモード。次の 2 つのモードのいずれかを正確に指定します。両方のモードが指定されている場合は、ブロックモードが使用されます。

モード	説明
WMDM_MODE_BLOCK	この操作は、ブロックモード処理を使用して実行されます。操作が完了するまで、呼び出しは返されません。
WMDM_MODE_THREAD	操作はスレッドモード処理を使用して実行されます。呼び出しはすぐに返され、操作はバックグラウンドスレッドで実行されます。

[in] pProgress

書式設定操作の進行状況を追跡するためにアプリケーションによって実装される IWMDMProgress インターフェイスへのポインター。このパラメーターは、NULL でもかまいません。

戻り値

このメソッドは HRESULT を返します。 Windows Media デバイスマネージャーのすべてのインターフェイスメソッドは、次のいずれかのエラーコードクラスを返すことができます。

標準 COM エラーコード
HRESULT 値に変換された Windows エラーコード
Windows Media デバイスマネージャーエラーコード

考えられるエラーコードの詳細な一覧については、「エラーコード」を参照してください。

注釈

WMDM_MODE_BLOCKを指定した場合、 Initialize は書式設定が完了するまで戻りません。 WMDM_MODE_THREADが指定されている場合、呼び出しはすぐに返され、呼び出し元は IMDSPStorageGlobals::GetStatus メソッドを使用して初期化操作を追跡できます。