Partager via


Méthode IAudioSessionControl2::GetProcessId (audiopolicy.h)

La méthode GetProcessId récupère l’identificateur de processus de la session audio.

Syntaxe

HRESULT GetProcessId(
  [out] DWORD *pRetVal
);

Paramètres

[out] pRetVal

Pointeur vers une variable DWORD qui reçoit l’identificateur de processus de la session audio.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Valeur retournée Description
E_POINTER
pRetVal a la valeur NULL.
AUDCLNT_S_NO_SINGLE_PROCESS
La session s’étend sur plusieurs processus. Dans ce cas, pRetVal reçoit l’identificateur initial du processus qui a créé la session. Pour utiliser cette valeur , incluez la définition suivante :

#define AUDCLNT_S_NO_SINGLE_PROCESS AUDCLNT_SUCCESS (0x00d)

AUDCLNT_E_DEVICE_INVALIDATED
La session audio est déconnectée sur le périphérique audio par défaut.

Remarques

Cette méthode remplace la valeur qui a été passée par l’application dans pRetVal.

GetProcessId vérifie si la session audio a été déconnectée sur l’appareil par défaut ou si la session a basculé vers un autre flux. Dans le cas d’un basculement de flux, cette méthode transfère les informations d’état du nouveau flux à la session. Les informations d’état incluent les contrôles de volume, les informations de métadonnées (nom complet, chemin d’icône) et le magasin de propriétés de la session.

Configuration requise

   
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête audiopolicy.h

Voir aussi

IAudioSessionControl2