Compartilhar via


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

O método GetProcessId recupera o identificador de processo da sessão de áudio.

Sintaxe

HRESULT GetProcessId(
  [out] DWORD *pRetVal
);

Parâmetros

[out] pRetVal

Ponteiro para uma variável DWORD que recebe o identificador de processo da sessão de áudio.

Valor retornado

Se o método for bem-sucedido, retornará S_OK. Se falhar, os códigos de retorno possíveis incluem, mas não se limitam a, os valores mostrados na tabela a seguir.

Valor retornado Descrição
E_POINTER
pRetVal é NULL.
AUDCLNT_S_NO_SINGLE_PROCESS
A sessão abrange mais de um processo. Nesse caso, pRetVal recebe o identificador inicial do processo que criou a sessão. Para usar esse valor , inclua a seguinte definição:

#define AUDCLNT_S_NO_SINGLE_PROCESS AUDCLNT_SUCCESS (0x00d)

AUDCLNT_E_DEVICE_INVALIDATED
A sessão de áudio é desconectada no dispositivo de áudio padrão.

Comentários

Esse método substitui o valor que foi passado pelo aplicativo em pRetVal.

GetProcessId verifica se a sessão de áudio foi desconectada no dispositivo padrão ou se a sessão mudou para outro fluxo. No caso da alternância de fluxo, esse método transfere informações de estado para o novo fluxo para a sessão. As informações de estado incluem controles de volume, informações de metadados (nome de exibição, caminho de ícone) e o repositório de propriedades da sessão.

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho audiopolicy.h

Confira também

IAudioSessionControl2