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

GetStatus メソッドは、デバイスの制御状態を取得します。

構文

HRESULT GetStatus(
  [out] DWORD *pdwStatus
);

パラメーター

[out] pdwStatus

デバイスの制御状態を指定する DWORD へのポインター。 コントロールの状態の値は、次のフラグの 1 つ以上を指定します。

フラグ	説明
WMDM_STATUS_READY	Windows Media デバイス マネージャーとそのサブコンポーネントは準備完了状態です。
WMDM_STATUS_BUSY	現在、操作が実行されています。 その他の状態値を評価して、それがどの操作であるかを判断します。
WMDM_STATUS_DEVICECONTROL_PLAYING	デバイスは現在再生中です。
WMDM_STATUS_DEVICECONTROL_RECORDING	デバイスは現在記録中です。
WMDM_STATUS_DEVICECONTROL_PAUSED	デバイスは現在一時停止しています。
WMDM_STATUS_DEVICECONTROL_REMOTE	デバイスの再生または記録操作は、アプリケーションによってリモートで制御されています。
WMDM_STATUS_DEVICECONTROL_STREAM	再生またはレコード方式は、メディア デバイス間でデータをストリーミングします。

戻り値

このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。

リターン コード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	pdwStatus パラメーターが無効または NULL ポインターです。
E_FAIL	未指定のエラーが発生しました。

解説

この呼び出しは、このインターフェイスのデバイス制御操作に固有の状態値を返します。 コントロールの状態は、再生、記録など、デバイスのコントロール関連アクティビティの状態に関する情報を提供できます。 ただし、デバイスがデータをダウンロードしているか、何らかの理由でアクセスされているかなど、デバイスのグローバル状態に関する情報を提供することはできません。 デバイス制御以外の理由でデバイスがビジー状態の場合は、ビジー コードを受け取り、詳細については IWMDMDeviceControl::GetStatus メソッドを呼び出す必要があります。

状態値WMDM_STATUS_BUSYが返され、状態値に状態値のテーブルの他の値が含まれていない場合は、このインターフェイスの Play、 Record、 Pause、 Resume、または Stop の各メソッドを呼び出してはいけません。

要件

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

こちらもご覧ください

IWMDMDeviceControl インターフェイス

IWMDMObjectInfo インターフェイス