ISpatialAudioObjectRenderStreamBase::GetService メソッド (spatialaudioclient.h)

  • [アーティクル]

ISpatialAudioObjectRenderStream から追加のサービスを取得します。

構文

HRESULT GetService(
  [in]  REFIID riid,
  [out] void   **service
);

パラメーター

[in] riid

要求されたサービスのインターフェイス ID。 クライアントは、このパラメーターを次のいずれかの REFIID 値に設定する必要があります。

IID_IAudioClock

IID_IAudioClock2

IID_IAudioStreamVolume

[out] service

メソッドが要求されたインターフェイスのインスタンスのアドレスを書き込むポインター変数へのポインター。 このメソッドを使用して、呼び出し元はインターフェイスへのカウントされた参照を取得します。 呼び出し元は、インターフェイスの Release メソッドを呼び出すことによって、不要になったインターフェイスを解放する必要があります。 GetService 呼び出しが失敗した場合、*ppv は NULL です。

戻り値

メソッドが成功した場合は、S_OK を返します。 エラーが発生した場合、次の表に示す値が、可能なリターン コードに含まれますが、これらに限定されません。

リターン コード 説明
E_POINTER
 パラメーター ppv は NULL です。
SPTLAUDCLNT_E_DESTROYED
 空間オーディオ ストリームに関連付けられている ISpatialAudioClient が破棄されました。
AUDCLNT_E_DEVICE_INVALIDATED
 オーディオ エンドポイント デバイスが取り外されているか、オーディオ ハードウェアまたは関連するハードウェア リソースが再構成、無効、削除、またはその他の方法で使用できなくなります。
SPTLAUDCLNT_E_INTERNAL
 内部エラーが発生しました。
AUDCLNT_E_UNSUPPORTED_FORMAT
 空間オーディオ ストリームに関連付けられているメディアでは、サポートされていない形式が使用されます。

注釈

GetService メソッドは、次のサービス インターフェイスをサポートしています。

要件

要件 値
対象プラットフォーム Windows
ヘッダー spatialaudioclient.h

こちらもご覧ください

ISpatialAudioObjectRenderStream

ISpatialAudioObjectRenderStreamBase