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

O método GetTopologyObject obtém uma referência à interface IDeviceTopology do objeto device-topology que contém essa parte.

Sintaxe

HRESULT GetTopologyObject(
  [out] IDeviceTopology **ppTopology
);

Parâmetros

[out] ppTopology

Ponteiro para uma variável de ponteiro na qual o método grava o endereço da interface IDeviceTopology do objeto device-topology. O chamador obtém uma referência contada à interface desse método. 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 GetTopologyObject falhar, *ppTopology será NULL.

Valor retornado

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 ppTopology é NULL.

Comentários

Para obter exemplos de código que usam esse método, consulte os seguintes tópicos:

• Topologias de dispositivo
• Usando a interface IKsControl para acessar propriedades de áudio

Requisitos

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

IDeviceTopology Interface

IPart Interface