IAudioSessionManager2::GetSessionEnumerator メソッド (audiopolicy.h)
GetSessionEnumerator メソッドは、オーディオ セッション列挙子オブジェクトへのポインターを取得します。
構文
HRESULT GetSessionEnumerator(
[out] IAudioSessionEnumerator **SessionEnum
);
パラメーター
[out] SessionEnum
クライアントがオーディオ デバイス上のオーディオ セッションを列挙するために使用できるセッション列挙子オブジェクトの IAudioSessionEnumerator インターフェイスへのポインターを受け取ります。 このメソッドを使用して、呼び出し元はインターフェイスへのカウントされた参照を取得します。 呼び出し元は、インターフェイスの Release メソッドを呼び出すことによって、不要になったインターフェイスを解放する必要があります。
戻り値
メソッドが成功した場合は、S_OK を返します。
注釈
セッション マネージャーは、オーディオ エンジンに対してクエリを実行することで、オーディオ デバイスでアクティブなオーディオ セッションのコレクションを保持します。 GetSessionEnumerator は、コレクション内の各セッションのセッション コントロールを作成します。 列挙コレクション内のセッションの IAudioSessionControl インターフェイスへの参照を取得するには、アプリケーションで IAudioSessionEnumerator::GetSession を呼び出す必要があります。 コード例については、「 IAudioSessionEnumerator インターフェイス」を参照してください。
セッション列挙子は、 IAudioSessionNotification を介して報告される新しいセッションを認識していない可能性があります。 そのため、アプリケーションがオーディオ エンドポイントのすべてのセッションを取得するためにセッション列挙子のみに依存している場合、結果が正確でない可能性があります。 これを回避するには、アプリケーションでリストを手動で管理する必要があります。 詳細については、「 IAudioSessionEnumerator」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | audiopolicy.h |