IAudioClient::GetService メソッド (audioclient.h)

[アーティクル]
03/14/2023

GetService メソッドは、オーディオクライアントオブジェクトから追加のサービスにアクセスします。

構文

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

パラメーター

[in] riid

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

IID_IAudioCaptureClient

IID_IAudioClientDuckingControl

IID_IAudioClock

IID_IAudioRenderClient

IID_IAudioSessionControl

IID_IAudioStreamVolume

IID_IChannelAudioVolume

IID_IMFTrustedOutput

IID_ISimpleAudioVolume

詳細については、「解説」を参照してください。

[out] ppv

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

戻り値

メソッドが成功した場合は、S_OK を返します。失敗した場合、次の表に示す値が含まれますが、これに限定されません。

リターンコード	説明
E_POINTER	パラメーター ppv は NULL です。
E_NOINTERFACE	要求されたインターフェイスは使用できません。
AUDCLNT_E_NOT_INITIALIZED	オーディオストリームが初期化されていません。
AUDCLNT_E_WRONG_ENDPOINT_TYPE	呼び出し元は、レンダリングエンドポイント上の IAudioCaptureClient インターフェイス、またはキャプチャエンドポイント上の IAudioRenderClient インターフェイスにアクセスしようとしました。
AUDCLNT_E_DEVICE_INVALIDATED	オーディオエンドポイントデバイスが取り外されているか、オーディオハードウェアまたは関連するハードウェアリソースが再構成、無効、削除、またはその他の方法で使用できなくなります。
AUDCLNT_E_SERVICE_NOT_RUNNING	Windows オーディオサービスが実行されていません。

注釈

このメソッドでは、 IAudioClient インターフェイスを事前に初期化する必要があります。クライアントが IAudioClient::Initialize メソッドを正常に呼び出してオーディオストリームを初期化するまで、このメソッドの呼び出しはすべてエラー AUDCLNT_E_NOT_INITIALIZEDで失敗します。

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

Windows 7 では、出力信頼機関 (OTA) オブジェクトの使用を容易にする新しいサービス識別子 ( IID_IMFTrustedOutput) が追加されました。これらのオブジェクトは、Media Foundation の保護されたメディアパス (PMP) の内部または外部で動作し、Media Foundation パイプラインの外部にコンテンツを送信できます。呼び出し元が PMP の外部にある場合、OTA は PMP で動作しない可能性があり、保護設定の堅牢性は低くなります。 OTA は、IMFTrustedOutput インターフェイスを実装する必要があります。 GetService で IID_IMFTrustedOutputを渡すことで、アプリケーションはオブジェクトの IMFTrustedOutput インターフェイスへのポインターを取得できます。保護されたオブジェクトと IMFTrustedOutput の詳細については、Media Foundation SDK ドキュメントの「保護されたメディアパス」を参照してください。

OTA で信頼できるオーディオドライバーを使用する方法については、「 Protected User Mode Audio (PUMA)」を参照してください。

このメカニズムを使用して IMFTrustedOutput をアクティブ化すると、呼び出し元が PMP で実行されているかどうかに関係なく機能することに注意してください。ただし、呼び出し元が保護されたプロセス (つまり、呼び出し元が Media Foundation の PMP 内にいない) で実行されていない場合、オーディオ OTA が PMP で動作せず、保護設定の堅牢性が低下する可能性があります。

サービスインターフェイスのインターフェイス ID を取得するには、 __uuidof 演算子を使用します。たとえば、 IAudioCaptureClient のインターフェイス ID は次のように定義されます。


const IID IID_IAudioCaptureClient  __uuidof(IAudioCaptureClient)

__uuidof 演算子の詳細については、Windows SDKのドキュメントを参照してください。

IAudioClient オブジェクトを解放し、関連付けられているすべてのリソースを解放するには、クライアントは、IAudioClient インターフェイス自体で Release を呼び出すことに加えて、GetService を呼び出して作成されたすべてのサービスオブジェクトへのすべての参照を解放する必要があります。クライアントは、 IAudioClient オブジェクトを解放するのと同じスレッドからサービスを解放する必要があります。

IAudioSessionControl、IAudioStreamVolume、IChannelAudioVolume、および ISimpleAudioVolume インターフェイスは、オーディオセッションと共有モードストリームの側面を制御および監視します。これらのインターフェイスは、排他モードストリームでは機能しません。

GetService メソッドを呼び出すコード例については、次のトピックを参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ \| UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \| UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	audioclient.h