Método IDeviceTopology::GetPartById (devicetopology.h)

Artigo
08/23/2023

O método GetPartById obtém uma parte identificada por sua ID local.

Sintaxe

HRESULT GetPartById(
  [in]  UINT  nId,
  [out] IPart **ppPart
);

Parâmetros

[in] nId

A parte a ser obtido. Esse parâmetro é a ID local da parte. Para obter mais informações, consulte Comentários.

[out] ppPart

Ponteiro para uma variável de ponteiro na qual o método grava o endereço da interface IPart do objeto part identificado por nId. Por meio desse método, o chamador obtém uma referência contada para a interface . O chamador é responsável por liberar a interface, quando ela não é mais necessária, chamando o método Release da interface. Se a chamada GetPartById falhar, *ppPart será NULL.

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_INVALIDARG	O parâmetro nId não é uma ID local válida.
E_POINTER	O ponteiro ppPart é NULL.

Comentários

Uma ID local é um número que identifica exclusivamente uma parte entre todas as partes em uma topologia de dispositivo. Os métodos IAudioInputSelector::GetSelection e IAudioOutputSelector::GetSelection recuperam a ID local de uma parte conectada. Os métodos IAudioInputSelector::SetSelection e IAudioOutputSelector::SetSelection selecionam a entrada ou a saída conectada a uma parte identificada por sua ID local. Quando você tiver um ponteiro para um objeto part, poderá chamar o método IPart::GetLocalId para obter a ID local da parte.

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