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

[アーティクル]
02/29/2024

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

構文

HRESULT Play();

戻り値

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

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

解説

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

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

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