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 |
|---|---|
|
O ponteiro ppParts é NULL. |
|
Essa parte não tem links para upstream partes. |
|
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 |