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

El método EnumPartsIncoming obtiene una lista de todas las partes entrantes, es decir, las partes que residen en rutas de acceso de datos que están ascendentes de esta parte.

Sintaxis

HRESULT EnumPartsIncoming(
  [out] IPartsList **ppParts
);

Parámetros

[out] ppParts

Puntero a una variable de puntero en la que el método escribe la dirección de una interfaz IPartsList que encapsula la lista de elementos que están inmediatamente ascendentes de esta parte. 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 EnumPartsIncoming , *ppParts 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_POINTER	El puntero ppParts es NULL.
E_NOTFOUND	Esta parte no tiene vínculos a partes ascendentes.
E_OUTOFMEMORY	Memoria insuficiente

Comentarios

Una aplicación cliente puede atravesar una topología de dispositivo en la dirección del flujo de datos de audio mediante una llamada iterativa a este método en cada paso del recorrido para obtener la lista de partes que están inmediatamente ascendentes de la parte actual.

Si esta parte no tiene vínculos a partes ascendentes, el método devuelve el código de error E_NOTFOUND y no crea una lista de elementos (*ppParts es NULL). Por ejemplo, el método devuelve este código de error si la interfaz IPart representa un conector a través del cual los datos entran en una topología de dispositivo.

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

Consulte también

IPart (Interfaz)

IPartsList (interfaz)