IMFCameraControlDefaultsCollection::GetOrAddControl-Methode (mfidl.h)

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 vor dem Start des Streamings oder nach dem Start des Streamings festgelegt werden muss.

controlSet

Eine GUID, die den Steuerelementsatz angibt, zu dem das Steuerelement gehört.

constrolId

Die ID des Steuerelements, das der Auflistung hinzugefügt werden soll. Dieser Wert muss eine ID im KSPROPERTYSETID_ExtendedCameraControl-Eigenschaftssatz sein.

controlSize

Die Größe des Steuerelements in Bytes. Dieser Wert muss größer oder gleich der Größe von KSPROPERTY sein.

dataSize

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

defaults

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

Rückgabewert

Ein HRESULT, einschließlich der folgenden:

Wert BESCHREIBUNG
S_OK Erfolg.

Hinweise

Für benutzerdefinierte Steuerelemente basieren controlSet und controlId auf dem benutzerdefinierten Steuerelement-DDI, der vom Kameratreiberhersteller veröffentlicht wurde. Ebenso basieren controlSize und dataSize auf dem vom Anbieter veröffentlichten DDI.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11 Build 22621
Unterstützte Mindestversion (Server) Windows 11 Build 22621
Kopfzeile mfidl.h