次の方法で共有

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

  • [アーティクル]

GetStatus メソッドは、ストレージ メディアの現在の状態を取得します。

構文

HRESULT GetStatus(
  [out] DWORD *pdwStatus
);

パラメーター

[out] pdwStatus

状態情報を含む DWORD へのポインター。 pdwStatus パラメーターでは、次の状態値を返すことができます。

Status 説明
WMDM_STATUS_READY メディアはアイドル状態です。
WMDM_STATUS_BUSY 操作は進行中です。 状態値を評価して、進行中の操作を決定します。
WMDM_STATUS_STORAGE_NOTPRESENT 媒体が存在しない。 複数のメディアをサポートするデバイスの場合、この値は IMDSPStorageGlobals インターフェイスからのみ報告されます。
WMDM_STATUS_STORAGE_INITIALIZING デバイスは現在、デバイス上のメディアの書式設定にビジー状態です。
WMDM_STATUS_STORAGE_BROKEN メディアが壊れています。 複数のメディアをサポートするデバイスの場合、この値は IMDSPStorageGlobals インターフェイスからのみ報告されます。
WMDM_STATUS_STORAGE_NOTSUPPORTED メディアはデバイスでサポートされていません。 複数のメディアをサポートするデバイスの場合、この値は IMDSPStorageGlobals インターフェイスからのみ返されます。
WMDM_STATUS_STORAGE_UNFORMATTED メディアは書式設定されていません。 複数のメディアをサポートするデバイスの場合、この値は IMDSPStorageGlobals インターフェイスからのみ報告されます。

戻り値

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

  • 標準 COM エラー コード
  • HRESULT 値に変換された Windows エラー コード
  • Windows Media デバイス マネージャー エラー コード
考えられるエラー コードの詳細な一覧については、「 エラー コード」を参照してください。

注釈

ストレージ メディアとの対話を試みる前に、常にこのメソッドを呼び出す必要があります。 他のインターフェイスが進行中の操作を呼び出した場合、返される状態値はWMDM_STATUS_BUSY。 この呼び出しから返された値を評価して、進行中の操作が IMDSPStorageGlobals インターフェイスから呼び出されたかどうかを判断できます。

このメソッドを実装する必要があります。 WMDM_E_NOTSUPPORTEDまたはE_NOTIMPLを返してはなりません。 詳細については、「 必須インターフェイスと省略可能なインターフェイス」を参照してください。

要件

要件 値
対象プラットフォーム Windows
ヘッダー mswmdm.h
Library Mssachlp.lib

こちらもご覧ください

IMDSPStorageGlobals インターフェイス