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

O método GetDeviceIdConnectedTo obtém o identificador de dispositivo do dispositivo de áudio, se houver, ao qual esse conector está conectado.

Sintaxe

HRESULT GetDeviceIdConnectedTo(
  [out] LPWSTR *ppwstrDeviceId
);

Parâmetros

[out] ppwstrDeviceId

Ponteiro para um ponteiro de cadeia de caracteres no qual o método grava o endereço de uma cadeia de caracteres largos terminada em nulo que contém o identificador de dispositivo do dispositivo conectado. O método aloca o armazenamento para a cadeia de caracteres. O chamador é responsável por liberar o armazenamento, quando ele não é mais necessário, chamando a função CoTaskMemFree . Se a chamada GetDeviceIdConnectedTo falhar, *ppwstrDeviceId será NULL. Para obter informações sobre CoTaskMemFree, consulte a documentação do SDK do Windows.

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_POINTER	O ponteiro ppwstrDeviceId é NULL.
E_NOTFOUND	Esse conector não está conectado ou o outro lado da conexão não é outra topologia de dispositivo (por exemplo, uma conexão Software_IO).
E_MEMORY	Sem memória.

Comentários

O identificador de dispositivo obtido desse método pode ser usado como um parâmetro de entrada para o método IMMDeviceEnumerator::GetDevice .

Esse método é funcionalmente equivalente a, mas mais eficiente do que, a seguinte série de chamadas de método:

• Chame o método IConnector::GetConnectedTo para obter a interface IConnector do conector "to".
• Chame o método IConnector::QueryInterface (com iid de parâmetro definido como IID_IPART REFIID ) para obter a interface IPart do conector "to".
• Chame o método IPart::GetTopologyObject para obter a interface IDeviceTopology do dispositivo "to" (o dispositivo que contém o conector "to").
• Chame o método IDeviceTopology::GetDeviceId para obter a ID do dispositivo "to".

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

IConnector Interface

IMMDeviceEnumerator::GetDevice