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 インターフェイス