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

El método SetSelection selecciona una de las entradas del selector de entrada.

Sintaxis

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

Parámetros

[in] nIdSelect

Nueva entrada del selector. El autor de la llamada debe establecer este parámetro en el identificador local de un elemento que tiene un vínculo directo a una de las entradas del selector.

[in] pguidEventContext

Valor de contexto del método IControlChangeNotify::OnNotify . Este parámetro apunta a un GUID de contexto de evento. Si la llamada a SetSelection cambia el estado del control de selector de entrada, todos los clientes que han registrado interfaces IControlChangeNotify con ese control reciben notificaciones. En su implementación del método OnNotify , un cliente puede inspeccionar el GUID de contexto de evento para detectar si es el origen del evento de cambio de control u otro cliente. Si el autor de la llamada proporciona un puntero NULL para este parámetro, el método de notificación del cliente recibe un puntero de contexto NULL .

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.

Código devuelto	Descripción
E_INVALIDARG	El parámetro nIdSelect no es el identificador local de un elemento en una entrada del selector.
E_OUTOFMEMORY	Memoria insuficiente

Comentarios

Un identificador local es un número que identifica de forma única una parte entre todas las partes de una topología de dispositivo. Para obtener el identificador local de un elemento, llame al método IPart::GetLocalId en el objeto part.

Para obtener un ejemplo de código que llama al método SetSelection , consulte la implementación de la función SelectCaptureDevice en Topologías de dispositivo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	devicetopology.h

Consulte también

IAudioInputSelector (Interfaz)

IPart::GetLocalId