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

  • Artículo

El método SetSelection selecciona una de las salidas del selector de salida.

Sintaxis

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

Parámetros

[in] nIdSelect

Nueva salida del selector. El llamador debe establecer este parámetro en el identificador local de un elemento que tiene un vínculo directo a una de las salidas 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 salida, 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 salida 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.

Requisitos

   
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

IAudioOutputSelector (Interfaz)

IPart::GetLocalId