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

Artículo
02/28/2024

El método GetPartById obtiene una parte identificada por su identificador local.

Sintaxis

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

Parámetros

[in] nId

Parte que se va a obtener. Este parámetro es el identificador local del elemento. Para obtener más información, vea la sección Comentarios.

[out] ppPart

Puntero a una variable de puntero en la que el método escribe la dirección de la interfaz IPart del objeto de elemento identificado por nId. A través de este método, el autor de la llamada obtiene una referencia contada a la interfaz . El autor de la llamada es responsable de liberar la interfaz, cuando ya no es necesario, llamando al método Release de la interfaz. Si se produce un error en la llamada a GetPartById , *ppPart es NULL.

Valor devuelto

Si el método se realiza correctamente, devuelve S_OK. Si se produce un error, los códigos de retorno posibles incluyen, entre otros, los valores que se muestran en la tabla siguiente.

Código devuelto	Descripción
E_INVALIDARG	El parámetro nId no es un identificador local válido.
E_POINTER	El puntero ppPart es NULL.

Comentarios

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 una parte conectada. Los métodos IAudioInputSelector::SetSelection e IAudioOutputSelector::SetSelection seleccionan la entrada o salida que está conectada a un elemento identificado por su identificador local. Cuando tiene un puntero a un objeto part, puede llamar al método IPart::GetLocalId para obtener el identificador local del elemento.

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