Metodo IPart::GetTopologyObject (devicetopology.h)

Il metodo GetTopologyObject ottiene un riferimento all'interfaccia IDeviceTopology dell'oggetto topologia del dispositivo che contiene questa parte.

Sintassi

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

Parametri

[out] ppTopology

Puntatore a una variabile puntatore in cui il metodo scrive l'indirizzo dell'interfaccia IDeviceTopology dell'oggetto topologia dispositivo. Il chiamante ottiene un riferimento contato all'interfaccia da questo metodo. Tramite questo metodo, il chiamante ottiene un riferimento conteggiato all'interfaccia. Il chiamante è responsabile del rilascio dell'interfaccia, quando non è più necessario, chiamando il metodo Release dell'interfaccia. Se la chiamata GetTopologyObject non riesce, *ppTopology è NULL.

Valore restituito

Se il metodo ha esito positivo, viene restituito S_OK. Se ha esito negativo, i possibili codici restituiti includono, ma non sono limitati, i valori illustrati nella tabella seguente.

Codice restituito	Descrizione
E_POINTER	Puntatore ppTopology è NULL.

Commenti

Per esempi di codice che usano questo metodo, vedere gli argomenti seguenti:

• Topologie di dispositivo
• Uso dell'interfaccia IKsControl per accedere alle proprietà audio

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	devicetopology.h

Vedi anche

Interfaccia IDeviceTopology

Interfaccia IPart