Método IPart::EnumPartsOutgoing (devicetopology.h)
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 |
|---|---|
|
O ponteiro ppParts é NULL. |
|
Essa parte não tem links para partes downstream. |
|
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 |