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

O método SetSelection seleciona uma das entradas do seletor de entrada.

Sintaxe

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

Parâmetros

[in] nIdSelect

A nova entrada do seletor. O chamador deve definir esse parâmetro como a ID local de uma parte que tenha um link direto para uma das entradas 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 entrada, 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 .

Retornar valor

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 entrada 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.

Para obter um exemplo de código que chama o método SetSelection , consulte a implementação da função SelectCaptureDevice em Topologias de Dispositivo.

Requisitos

Requisito Valor
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

IAudioInputSelector Interface

IPart::GetLocalId