IWMDMStorageGlobals::Initialize メソッド (mswmdm.h)
Initialize メソッドは、ストレージ メディアの書式を設定します。
構文
HRESULT Initialize(
[in] UINT fuMode,
[in] IWMDMProgress *pProgress
);
パラメーター
[in] fuMode
メディアの初期化に使用されるモード。 次の 2 つのモードのいずれかを指定します。 両方のモードが指定されている場合は、ブロック モードが使用されます。
モード | 説明 |
---|---|
WMDM_MODE_BLOCK | この操作は、ブロック モード処理を使用して実行されます。 操作が完了するまで、呼び出しは返されません。 |
WMDM_MODE_THREAD | この操作は、スレッド モードの処理を使用して実行されます。 呼び出しはすぐに返され、操作はバックグラウンド スレッドで実行されます。 |
[in] pProgress
書式設定操作の進行状況を追跡するためにアプリケーションによって実装される IWMDMProgress インターフェイスへのポインター。
戻り値
このメソッドは HRESULT を返します。 Windows Media デバイス マネージャーのすべてのインターフェイス メソッドは、次のいずれかのエラー コード クラスを返すことができます。
- 標準 COM エラー コード
- HRESULT 値に変換された Windows エラー コード
- Windows Media デバイス マネージャー エラー コード
注釈
アプリケーションで WMDM_MODE_THREAD を使用し、null 以外の pProgress パラメーターを渡す場合、アプリケーションは、読み取り操作が完了するまで pProgress が属するオブジェクトが破棄されないようにする必要があります。これは、Windows Media デバイス マネージャーがこのオブジェクトに進行状況通知を送信するためです。 このオブジェクトは、 End 通知を受信した後にのみ破棄できます。 これを行わないと、アクセス違反が発生します。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | mswmdm.h |
Library | Mssachlp.lib |