Metodo IAudioSessionControl2::GetProcessId (audiopolicy.h)

Il metodo GetProcessId recupera l'identificatore del processo della sessione audio.

Sintassi

HRESULT GetProcessId(
  [out] DWORD *pRetVal
);

Parametri

[out] pRetVal

Puntatore a una variabile DWORD che riceve l'identificatore del processo della sessione audio.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Valore restituito Descrizione
E_POINTER
pRetVal è NULL.
AUDCLNT_S_NO_SINGLE_PROCESS
La sessione si estende su più processi. In questo caso , pRetVal riceve l'identificatore iniziale del processo che ha creato la sessione. Per usare questo valore , includere la definizione seguente:

#define AUDCLNT_S_NO_SINGLE_PROCESS AUDCLNT_SUCCESS (0x00d)

AUDCLNT_E_DEVICE_INVALIDATED
La sessione audio è disconnessa nel dispositivo audio predefinito.

Commenti

Questo metodo sovrascrive il valore passato dall'applicazione in pRetVal.

GetProcessId controlla se la sessione audio è stata disconnessa nel dispositivo predefinito o se la sessione è passata a un altro flusso. Nel caso del cambio di flusso, questo metodo trasferisce le informazioni sullo stato per il nuovo flusso alla sessione. Le informazioni sullo stato includono controlli volume, informazioni sui metadati (nome visualizzato, percorso icona) e archivio delle proprietà della sessione.

Requisiti

   
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione audiopolicy.h

Vedi anche

IAudioSessionControl2