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 |
|---|---|
|
pRetVal é NULL. |
|
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:
|
|
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 |