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.

Código de retorno Descrição
E_POINTER
O ponteiro ppParts é NULL.
E_NOTFOUND
Essa parte não tem links para upstream partes.
E_OUTOFMEMORY
Sem memória.

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

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho devicetopology.h

Confira também

IPart Interface

IPartsList Interface