IMFVirtualCamera::AddProperty-Methode (mfvirtualcamera.h)

Artikel
02/29/2024

Fügt der virtuellen Kamera benutzerdefinierte Geräteschnittstelleneigenschaften hinzu.

Syntax

HRESULT AddProperty(
  const DEVPROPKEY *pKey,
  DEVPROPTYPE      Type,
  const BYTE       *pbData,
  ULONG            cbData
);

Parameter

pKey

Zeiger auf einen DEVPROPKEY , der der Geräteschnittstelle der virtuellen Kamera hinzugefügt werden soll. Weitere Informationen finden Sie unter Unified Device-Eigenschaftsmodell.

Type

Eigenschaftentyp für den angegebenen pKey. Die Typen DEVPROP_TYPE_NULL und DEVPROP_TYPE_EMPTY werden nicht unterstützt.

pbData

Zeiger auf die Eigenschaftendaten.

cbData

Größe in Bytes, die im Puffer enthalten sind, auf den die Daten verweisen.

Rückgabewert

Gibt einen HRESULT-Wert zurück, einschließlich, aber nicht beschränkt auf die folgenden Werte:

Fehlercode	BESCHREIBUNG
S_OK	Erfolgreich
E_INVALIDARG	Ein Eingabeparameter ist ungültig.
E_ACCESSDENIED	Der Aufrufer verfügt über unzureichende Berechtigungen zum Hinzufügen von Eigenschaften.

Hinweise

Aufrufer müssen über Berechtigungen auf Administratorebene verfügen, um diese API verwenden zu können. UWP und gepackte Apps verfügen nicht über Berechtigungen zum Aufrufen dieser Methode.

Aufrufer sollten beim Hinzufügen bekannter Windows-Geräteeigenschaften Vorsicht walten lassen, da dies unbeabsichtigte Auswirkungen haben kann.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Build 22000
Kopfzeile	mfvirtualcamera.h
Bibliothek	mfsensorgroup.lib
DLL	mfsensorgroup.dll

Freigeben über