IAudioSessionControl2::GetProcessId メソッド (audiopolicy.h)

GetProcessId メソッドは、オーディオ セッションのプロセス識別子を取得します。

構文

HRESULT GetProcessId(
  [out] DWORD *pRetVal
);

パラメーター

[out] pRetVal

オーディオ セッションのプロセス識別子を受け取る DWORD 変数へのポインター。

戻り値

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

戻り値	説明
E_POINTER	pRetVal は NULL です。
AUDCLNT_S_NO_SINGLE_PROCESS	セッションは複数のプロセスにまたがる。 この場合、 pRetVal はセッションを作成したプロセスの初期識別子を受け取ります。 この値を使用するには、次の定義を含めます。 #define AUDCLNT_S_NO_SINGLE_PROCESS AUDCLNT_SUCCESS (0x00d)
AUDCLNT_E_DEVICE_INVALIDATED	オーディオ セッションは、既定のオーディオ デバイスで切断されます。

解説

このメソッドは、 pRetVal でアプリケーションによって渡された値を上書きします。

GetProcessId は、オーディオ セッションが既定のデバイスで切断されているかどうか、またはセッションが別のストリームに切り替えられたかどうかを確認します。 ストリーム切り替えの場合、このメソッドは新しいストリームの状態情報をセッションに転送します。 状態情報には、ボリューム コントロール、メタデータ情報 (表示名、アイコン パス)、セッションのプロパティ ストアが含まれます。

要件

サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	audiopolicy.h

関連項目

IAudioSessionControl2