IMDSPDeviceControl::P lay メソッド (mswmdm.h)

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

Play メソッドは、現在のシーク位置で再生を開始します。 Seek メソッドが呼び出されていない場合、再生は最初のファイルの先頭から開始され、再生の長さは定義されません。

構文

HRESULT Play();

戻り値

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

リターンコード	説明
S_OK	メソッドが成功しました。
E_BUSY	デバイスがビジー状態です。
WMDM_E_NOTSUPPORTED	play 関数は、このデバイスには実装されていません。
E_FAIL	未指定のエラーが発生しました。

解説

このメソッドは、デバイスの再生 (メディアデバイスのストレージメディアでのオーディオトラックの再生) とストリーミングオーディオ再生 (ユーザーのコンピューターから再生されるメディアデバイスへのオーディオデータのストリーミング) の両方を呼び出すために使用されます。 Seek メソッドは、発生する再生の形式を決定します。

一部のデバイスでは、デバイスの再生またはストリーミングオーディオ再生がサポートされていません。特定の型の再生を開始する前に、 GetCapabilities メソッドを呼び出す必要があります。サポートされていない再生が試行された場合、このメソッドはWMDM_E_NOTSUPPORTEDを返します。

再生操作を呼び出す前に、メディアデバイスでオーディオ形式を再生できるかどうかを確認するには、 IMDSPDevice::GetFormatSupport メソッドを呼び出します。