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

El método EnumPartsOutgoing recupera una lista de todas las partes salientes, es decir, las partes que residen en rutas de acceso de datos que están de bajada de esta parte.

Sintaxis

HRESULT EnumPartsOutgoing(
  [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 de bajada 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 EnumPartsOutgoing , *ppParts es NULL.

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.

Comentarios

Una aplicación cliente puede recorrer una topología de dispositivo en la dirección del flujo de datos de audio llamando iterativamente a este método en cada paso del recorrido para obtener la lista de elementos que se encuentran inmediatamente de bajada desde la parte actual.

Si esta parte no tiene vínculos a partes descendentes, el método devuelve el código de error E_NOTFOUND y no crea una lista de partes (*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 salen de una topología de dispositivo.

Para obtener un ejemplo de código que usa el método EnumPartsOutgoing , consulte la implementación de la función SelectCaptureDevice en Topologías de dispositivo.

Requisitos

Consulte también

IPart (interfaz)

IPartsList (interfaz)