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

El método GetProcessId recupera el identificador de proceso de la sesión de audio.

Sintaxis

HRESULT GetProcessId(
  [out] DWORD *pRetVal
);

Parámetros

[out] pRetVal

Puntero a una variable DWORD que recibe el identificador de proceso de la sesión de audio.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Valor devuelto Descripción
E_POINTER
pRetVal es NULL.
AUDCLNT_S_NO_SINGLE_PROCESS
La sesión abarca más de un proceso. En este caso, pRetVal recibe el identificador inicial del proceso que creó la sesión. Para usar este valor , incluya la siguiente definición:

#define AUDCLNT_S_NO_SINGLE_PROCESS AUDCLNT_SUCCESS (0x00d)

AUDCLNT_E_DEVICE_INVALIDATED
La sesión de audio se desconecta en el dispositivo de audio predeterminado.

Comentarios

Este método sobrescribe el valor pasado por la aplicación en pRetVal.

GetProcessId comprueba si la sesión de audio se ha desconectado en el dispositivo predeterminado o si la sesión ha cambiado a otra secuencia. En el caso del cambio de secuencia, este método transfiere información de estado de la nueva secuencia a la sesión. La información de estado incluye controles de volumen, información de metadatos (nombre para mostrar, ruta de acceso del icono) y el almacén de propiedades de la sesión.

Requisitos

   
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado audiopolicy.h

Consulte también

IAudioSessionControl2