Freigeben über


IPart::GetControlInterface-Methode (devicetopology.h)

Die GetControlInterface-Methode ruft einen Verweis auf die angegebene Steuerelementschnittstelle ab, wenn diese von diesem Teil unterstützt wird.

Syntax

HRESULT GetControlInterface(
  [in]  UINT              nIndex,
  [out] IControlInterface **ppInterfaceDesc
);

Parameter

[in] nIndex

Die Steuerschnittstellennummer. Wenn ein Teil n Steuerschnittstellen unterstützt, werden die Steuerschnittstellen von 0 bis n– 1 nummeriert.

[out] ppInterfaceDesc

Zeiger auf eine Zeigervariable, in die die Methode die Adresse der IControlInterface-Schnittstelle der angegebenen Audiofunktion schreibt. Mit dieser Methode erhält der Aufrufer einen gezählten Verweis auf die Schnittstelle. Der Aufrufer ist für die Freigabe der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem er die Release-Methode der Schnittstelle aufruft. Wenn der GetControlInterface-Aufruf fehlschlägt, ist *ppFunctionNULL.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, umfassen mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte, sind jedoch nicht darauf beschränkt.

Rückgabecode Beschreibung
E_POINTER
Zeiger ppFunction ist NULL.
E_INVALIDARG
Parameter nIndex liegt außerhalb des Bereichs.
E_NOTFOUND
Das Teil verfügt nicht über eine Steuerungsschnittstelle.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile devicetopology.h

Weitere Informationen

IControlInterface-Schnittstelle

IPart-Schnittstelle