Método IPart::GetLocalId (devicetopology.h)
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 |
|---|---|
|
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 |
Confira também
IAudioInputSelector::GetSelection
IAudioInputSelector::SetSelection
IAudioOutputSelector::GetSelection