Método IConnector::GetDeviceIdConnectedTo (devicetopology.h)

El método GetDeviceIdConnectedTo obtiene el identificador de dispositivo del dispositivo de audio, si existe, al que está conectado este conector.

Sintaxis

HRESULT GetDeviceIdConnectedTo(
  [out] LPWSTR *ppwstrDeviceId
);

Parámetros

[out] ppwstrDeviceId

Puntero a un puntero de cadena en el que el método escribe la dirección de una cadena de caracteres anchos terminada en NULL que contiene el identificador de dispositivo del dispositivo conectado. El método asigna el almacenamiento para la cadena. El autor de la llamada es responsable de liberar el almacenamiento, cuando ya no es necesario, llamando a la función CoTaskMemFree . Si se produce un error en la llamada a GetDeviceIdConnectedTo , *ppwstrDeviceId es NULL. Para obtener información sobre CoTaskMemFree, consulte la documentación de Windows SDK.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los posibles códigos de retorno incluyen, pero no están limitados a, los valores que se muestran en la tabla siguiente.

Código devuelto	Descripción
E_POINTER	El puntero ppwstrDeviceId es NULL.
E_NOTFOUND	Este conector no está conectado o el otro lado de la conexión no es otra topología de dispositivo (por ejemplo, una conexión Software_IO).
E_MEMORY	Memoria insuficiente

Comentarios

El identificador de dispositivo obtenido de este método se puede usar como parámetro de entrada para el método IMMDeviceEnumerator::GetDevice .

Este método es funcionalmente equivalente a, pero más eficaz que, la siguiente serie de llamadas de método:

• Llame al método IConnector::GetConnectedTo para obtener la interfaz IConnector del conector "to".
• Llame al método IConnector::QueryInterface (con el parámetro iid establecido en REFIID IID_IPart) para obtener la interfaz IPart del conector "to".
• Llame al método IPart::GetTopologyObject para obtener la interfaz IDeviceTopology del dispositivo "to" (el dispositivo que contiene el conector "to").
• Llame al método IDeviceTopology::GetDeviceId para obtener el identificador de dispositivo del dispositivo "to".

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

IConnector (Interfaz)

IMMDeviceEnumerator::GetDevice