Método IAudioOutputSelector::SetSelection (devicetopology.h)

  • Artigo

O método SetSelection seleciona uma das saídas do seletor de saída.

Sintaxe

HRESULT SetSelection(
  [in] UINT    nIdSelect,
  [in] LPCGUID pguidEventContext
);

Parâmetros

[in] nIdSelect

A saída do novo seletor. O chamador deve definir esse parâmetro para a ID local de uma parte que tenha um link direto para uma das saídas do seletor.

[in] pguidEventContext

Valor de contexto para o método IControlChangeNotify::OnNotify . Esse parâmetro aponta para um GUID de contexto de evento. Se a chamada SetSelection alterar o estado do controle seletor de saída, todos os clientes que registraram interfaces IControlChangeNotify com esse controle receberão notificações. Em sua implementação do método OnNotify , um cliente pode inspecionar o GUID de contexto de evento para descobrir se ele ou outro cliente é a origem do evento control-change. Se o chamador fornecer um ponteiro NULL para esse parâmetro, o método de notificação do cliente receberá um ponteiro de contexto NULL .

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.

Código de retorno Descrição
E_INVALIDARG
 O parâmetro nIdSelect não é a ID local de uma parte em uma saída de seletor.
E_OUTOFMEMORY
 Sem memória.

Comentários

Uma ID local é um número que identifica exclusivamente uma parte entre todas as partes em uma topologia de dispositivo. Para obter a ID local de uma parte, chame o método IPart::GetLocalId no objeto part.

Requisitos

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

Confira também

IAudioOutputSelector Interface

IPart::GetLocalId