IPart::GetControlInterface-Methode (devicetopology.h)

Artikel
08/23/2023

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

Share via