IMFCameraControlDefaultsCollection::GetOrAddControl-Methode (mfidl.h)

Artikel
11/18/2024

Fügt der Kamerasteuerungssammlung ein neues Kamerasteuerelement hinzu.

Syntax

HRESULT GetOrAddControl(
  MF_CAMERA_CONTROL_CONFIGURATION_TYPE configType,
  REFGUID                              controlSet,
  ULONG                                constrolId,
  ULONG                                controlSize,
  ULONG                                dataSize,
  IMFCameraControlDefaults             **defaults
);

Parameter

configType

Ein Wert aus dem MF_CAMERA_CONTROL_CONFIGURATION_TYPE, der angibt, ob der Steuerelementwert festgelegt werden muss, bevor das Streaming beginnt oder nach dem Streamingstart.

controlSet

Eine GUID, die den Steuerelementsatz angibt, zu dem das Steuerelement gehört. Wenn das controlSet-KSPROPERTYSETID_ExtendedCameraControl verwenden Sie bitte die dedizierte GetOrAddExtendedControl--Funktion.

constrolId

Die ID des Steuerelements, das der Auflistung hinzugefügt werden soll.

controlSize

Die Größe des Steuerelements in Byte. Dieser Wert muss größer oder gleich der Größe von KSPROPERTYsein.

dataSize

Die Größe der Datennutzlast für das Steuerelement in Byte.

defaults

Empfängt einen Zeiger auf eine IMFCameraControlDefaults Instanz, die das hinzugefügte Steuerelement darstellt.

Rückgabewert

Ein HRESULT, einschließlich der folgenden:

Wert	Beschreibung
S_OK	Erfolg.

Bemerkungen

Für benutzerdefinierte Steuerelemente basieren controlSet- und controlId- auf dem vom Hersteller des Kameratreibers veröffentlichten benutzerdefinierten Steuerelement-DDI. Ebenso basieren die controlSize und dataSize auf dem vom Anbieter veröffentlichten DDI.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 11 Build 22621
mindestens unterstützte Server-	Windows 11 Build 22621
Header-	mfidl.h

Freigeben über