Share via

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

  • Artigo

O método EnumPartsOutgoing recupera uma lista de todas as partes de saída, ou seja, as partes que residem em caminhos de dados que são downstream dessa parte.

Sintaxe

HRESULT EnumPartsOutgoing(
  [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 downstream desta 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 EnumPartsOutgoing 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 partes downstream.
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 ficam imediatamente downstream da parte atual.

Se essa parte não tiver links para partes downstream, 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 sairão de uma topologia do dispositivo.

Para obter um exemplo de código que usa o método EnumPartsOutgoing , consulte a implementação da função SelectCaptureDevice em Topologias de 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