IMFCameraControlDefaultsCollection::GetOrAddExtendedControl-Methode (mfidl.h)

  • Artikel

Fügt der Kamerasteuerelementsammlung ein neues erweitertes Kamerasteuerelement hinzu.

Syntax

HRESULT GetOrAddExtendedControl(
  [in]  MF_CAMERA_CONTROL_CONFIGURATION_TYPE configType,
  [in]  ULONG                                constrolId,
  [in]  DWORD                                streamId,
  [in]  ULONG                                dataSize,
  [out] IMFCameraControlDefaults             **defaults
);

Parameter

[in] 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.

[in] constrolId

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

[in] streamId

Die ID des Datenstroms, der dem Steuerelement zugeordnet ist. Dieser Paramater wird nur für Pin-Level-Steuerelemente verwendet. Andernfalls wird dieser Wert ignoriert.

[in] dataSize

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

[out] 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.
MF_E_INVALIDREQUEST Die angegebene Steuerelement-ID ist nicht im KSPROPERTYSETID_ExtendedCameraControl-Eigenschaftssatz enthalten.

Hinweise

Die Größe der Datennutzlast kann für verschiedene Steuerelemente variieren. Der dataSize-Wert muss für das Steuerelementnutzlastschema gültig sein, damit das Steuerelement den erforderlichen Puffer reservieren kann.

Anforderungen

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