IWMDMStorageGlobals::GetStatus メソッド (mswmdm.h)
GetStatus メソッドは、ストレージ メディアの現在の状態を取得します。
構文
HRESULT GetStatus(
[out] DWORD *pdwStatus
);
パラメーター
[out] pdwStatus
メソッドが返されたときに状態情報を受け取る DWORD へのポインター。 pdwStatus パラメーターでは、次の値を返すことができます。
Status | 説明 |
---|---|
WMDM_STATUS_READY | メディアはアイドル状態または準備完了状態です。 |
WMDM_STATUS_BUSY | 操作は進行中です。 状態値を評価して、進行中の操作を決定します。 |
WMDM_STATUS_STORAGE_NOTPRESENT | ストレージ メディアが存在しません。 複数のメディアがサポートされているデバイスの場合、この値は IWMDMStorageGlobals インターフェイスからのみ報告されます。 |
WMDM_STATUS_STORAGE_INITIALIZING | デバイスは現在、デバイス上のストレージ メディアの書式設定にビジー状態です。 |
WMDM_STATUS_STORAGE_BROKEN | ストレージ メディアが壊れています。 複数のメディアがサポートされているデバイスの場合、この値は IWMDMStorageGlobals インターフェイスからのみ報告されます。 |
WMDM_STATUS_STORAGE_NOTSUPPORTED | ストレージ メディアは、デバイスではサポートされていません。 複数のメディアがサポートされているデバイスの場合、この値は IWMDMStorageGlobals インターフェイスからのみ返されます。 |
WMDM_STATUS_STORAGE_UNFORMATTED | ストレージ メディアは書式設定されていません。 複数のメディアがサポートされているデバイスの場合、この値は IWMDMStorageGlobals インターフェイスからのみ報告されます。 |
戻り値
このメソッドは HRESULT を返します。 Windows Media デバイス マネージャーのすべてのインターフェイス メソッドは、次のいずれかのエラー コード クラスを返すことができます。
- 標準 COM エラー コード
- HRESULT 値に変換された Windows エラー コード
- Windows Media デバイス マネージャー エラー コード
注釈
呼び出し元がストレージ メディアとの対話を試みる前に、常にこのメソッドを呼び出す必要があります。 取得された状態値は、他のインターフェイスが進行中の操作を呼び出した場合にWMDM_STATUS_BUSYされます。 この呼び出しから取得した値を評価して、進行中の操作が IWMDMStorageGlobals インターフェイスから呼び出されたかどうかを判断できます。
要件
要件 | 値 |
---|---|
対象プラットフォーム | Windows |
ヘッダー | mswmdm.h |
Library | Mssachlp.lib |