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

Artículo
02/29/2024

El método GetLocalId obtiene el identificador local de esta parte.

Sintaxis

HRESULT GetLocalId(
  [out] UINT *pnId
);

Parámetros

[out] pnId

Puntero a una variable UINT en la que el método escribe el identificador local de esta parte.

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 pnId es NULL.

Comentarios

Cuando tenga un puntero a un objeto part, puede llamar a este método para obtener el identificador local del elemento. Un identificador local es un número que identifica de forma única una parte entre todas las partes de una topología de dispositivo.

Los métodos IAudioInputSelector::GetSelection e IAudioOutputSelector::GetSelection recuperan el identificador local de un elemento conectado. Los métodos IAudioInputSelector::SetSelection e IAudioOutputSelector::SetSelection seleccionan la entrada o salida que está conectada a una parte identificada por su identificador local. El método IDeviceTopology::GetPartById obtiene una parte identificada por su identificador local.

Para obtener ejemplos de código que usan el método GetLocalId , consulte los temas siguientes:

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