Método IPart::GetLocalId (devicetopology.h)

Artigo
03/05/2024

O método GetLocalId obtém a ID local desta parte.

Sintaxe

HRESULT GetLocalId(
  [out] UINT *pnId
);

Parâmetros

[out] pnId

Ponteiro para uma variável UINT na qual o método grava a ID local dessa parte.

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 pnId do ponteiro é NULL.

Comentários

Quando você tem um ponteiro para um objeto part, você pode chamar esse método para obter a ID local da parte. 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. O método IDeviceTopology::GetPartById obtém uma parte identificada por sua ID local.

Para obter exemplos de código que usam o método GetLocalId , consulte os seguintes tópicos:

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