IAudioSessionControl2::GetProcessId 方法 (audiopolicy.h)

GetProcessId方法會擷取音訊會話的進程識別碼。

語法

HRESULT GetProcessId(
  [out] DWORD *pRetVal
);

參數

[out] pRetVal

接收音訊會話進程識別碼的 DWORD 變數指標。

傳回值

如果方法成功,它會傳回 S_OK。 如果失敗,可能的傳回碼包括,但不限於下表所示的值。

傳回值 描述
E_POINTER
pRetValNull
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