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

O método EnumPartsIncoming obtém uma lista de todas as partes de entrada, ou seja, as partes que residem em caminhos de dados que são upstream desta parte.

Sintaxe

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

Parâmetros

[out] ppParts

Ponteiro para uma variável de ponteiro na qual o método grava o endereço de uma interface IPartsList que encapsula a lista de partes que são imediatamente upstream dessa parte. Por meio desse método, o chamador obtém uma referência contada à interface . O chamador é responsável por liberar a interface, quando ela não é mais necessária, chamando o método Release da interface. Se a chamada EnumPartsIncoming falhar, *ppParts será NULL.

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.

Comentários

Um aplicativo cliente pode percorrer uma topologia de dispositivo na direção do fluxo de dados de áudio chamando iterativamente esse método em cada etapa na passagem para obter a lista de partes que estão imediatamente upstream da parte atual.

Se essa parte não tiver links para upstream partes, o método retornará o código de erro E_NOTFOUND e não criará uma lista de partes (*ppParts é NULL). Por exemplo, o método retornará esse código de erro se a interface IPart representar um conector por meio do qual os dados entram em uma topologia do dispositivo.

Requisitos

Confira também

IPart Interface

IPartsList Interface