Compartir a través de


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