IMDSPDeviceControl::GetDCStatus メソッド (mswmdm.h)

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

構文

HRESULT GetDCStatus(
  [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	未指定のエラーが発生しました。

解説

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

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

要件

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

こちらもご覧ください

IMDSPDeviceControl インターフェイス