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

[アーティクル]
08/25/2023

GetStatus メソッドは、デバイスが提供できるすべてのデバイス状態情報を取得します。

構文

HRESULT GetStatus(
  [out] DWORD *pdwStatus
);

パラメーター

[out] pdwStatus

現在のデバイスの状態を受け取る DWORD へのポインター。これらの状態値は、次の表で定義されています。

Status	説明
WMDM_STATUS_READY	Windows Media デバイスマネージャーとそのサブコンポーネントは準備完了状態です。
WMDM_STATUS_BUSY	操作は進行中です。その他の状態値を調べて、それがどの操作であるかを判断します。
WMDM_STATUS_DEVICE_NOTPRESENT	デバイスがコンピューターに接続されていません。
WMDM_STATUS_STORAGE_NOTPRESENT	メディアが存在しません。複数のメディアをサポートするデバイスの場合、この値は IWMDMStorageGlobals インターフェイスからのみ報告されます。
WMDM_STATUS_STORAGE_INITIALIZING	デバイスは現在、デバイス上のメディアの書式設定にビジー状態です。
WMDM_STATUS_STORAGE_BROKEN	メディアが機能していません。複数のメディアをサポートするデバイスの場合、この値は IWMDMStorageGlobals インターフェイスからのみ報告されます。
WMDM_STATUS_STORAGE_NOTSUPPORTED	メディアはデバイスでサポートされていません。複数のメディアをサポートするデバイスの場合、この値は IWMDMStorageGlobals インターフェイスからのみ返されます。
WMDM_STATUS_STORAGE_UNFORMATTED	メディアは書式設定されていません。複数のメディアをサポートするデバイスの場合、この値は IWMDMStorageGlobals インターフェイスからのみ返されます。
WMDM_STATUS_STORAGECONTROL_INSERTING	IWMDMStorageControl::Insert メソッドは現在実行中です。
WMDM_STATUS_STORAGECONTROL_DELETING	IWMDMStorageControl::D elete メソッドは現在実行中です。
WMDM_STATUS_STORAGECONTROL_MOVING	IWMDMStorageControl::Move メソッドは現在実行中です。
WMDM_STATUS_STORAGECONTROL_READING	IWMDMStorageControl::Read メソッドは現在実行中です。

戻り値

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

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

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

注釈

この呼び出しから 1 つ以上の状態値を返すことができます。メディアデバイスのすべてのインターフェイスのすべての状態値は、この呼び出しを通じて報告されます。たとえば、メディアデバイスへのファイルの書き込みなどのストレージ操作が進行中の場合、このメソッドを呼び出すと、その操作のビジー状態が報告されます。進行中の操作の場合、状態値WMDM_STATUS_BUSYは常に存在します。

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