IPart::Activate-Methode (devicetopology.h)

Artikel
08/23/2023

Die Activate-Methode aktiviert eine funktionsspezifische Schnittstelle für einen Connector oder eine Untereinheit.

Syntax

HRESULT Activate(
  [in]  DWORD  dwClsContext,
  [in]  REFIID refiid,
  [out] void   **ppvObject
);

Parameter

[in] dwClsContext

Der Ausführungskontext, in dem der Code ausgeführt wird, der das neu erstellte Objekt verwaltet. Der Aufrufer kann den Kontext einschränken, indem er diesen Parameter auf den bitweisen OR eines oder mehrerer CLSCTX-Enumerationswerte festlegt. Der Client kann kontextbezogene Einschränkungen vermeiden, indem er CLSCTX_ALL angibt. Weitere Informationen zu CLSCTX finden Sie in der Windows SDK-Dokumentation.

[in] refiid

Die Schnittstellen-ID für die angeforderte Steuerungsfunktion. Der Client sollte diesen Parameter auf einen der folgenden REFIID-Werte festlegen:

IID_IAudioAutoGainControl

IID_IAudioBass

IID_IAudioChannelConfig

IID_IAudioInputSelector

IID_IAudioLoudness

IID_IAudioMidrange

IID_IAudioMute

IID_IAudioOutputSelector

IID_IAudioPeakMeter

IID_IAudioTreble

IID_IAudioVolumeLevel

IID_IDeviceSpecificProperty

IID_IKsFormatSupport

IID_IKsJackDescription

IID_IKsJackDescription2

Weitere Informationen finden Sie in den Hinweisen.

[out] ppvObject

Zeiger auf eine Zeigervariable, in die die -Methode die Adresse der Schnittstelle schreibt, die durch den Parameter refiid angegeben wird. Mit dieser Methode erhält der Aufrufer einen gezählten Verweis auf die Schnittstelle. Der Aufrufer ist für das Freigeben der Schnittstelle verantwortlich, wenn sie nicht mehr benötigt wird, indem die Release-Methode der Schnittstelle aufgerufen wird. Wenn der Activate-Aufruf fehlschlägt, ist *ppObjectNULL.

Rückgabewert

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

Rückgabecode	Beschreibung
E_INVALIDARG	Das CLSCTX_INPROC_SERVER Bit in dwClsContext ist 0.
E_POINTER	Zeiger ppvObject ist NULL.
E_NOINTERFACE	Das Part-Objekt unterstützt die angeforderte Schnittstelle nicht.

Hinweise

Die Activate-Methode unterstützt die folgenden funktionsspezifischen Steuerungsschnittstellen:

Um die Schnittstellen-ID der funktionsspezifischen Steuerelementschnittstelle eines Teils abzurufen, rufen Sie die IControlInterface::GetIID-Methode des Teils auf. Verwenden Sie den __uuidof-Operator , um die Schnittstellen-ID eines funktionsspezifischen Steuerelementschnittstellentyps abzurufen. Die Schnittstellen-ID von IAudioAutoGainControl ist beispielsweise wie folgt definiert:


const IID IID_IAudioAutoGainControl  __uuidof(IAudioAutoGainControl)

Weitere Informationen zum __uuidof-Operator finden Sie in der Dokumentation zum Windows SDK.

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::GetIID

IPart-Schnittstelle

Share via