Méthode IMFVirtualCamera ::AddProperty (mfvirtualcamera.h)

Article
03/04/2024

Ajoute des propriétés d’interface d’appareil personnalisées à la caméra virtuelle.

Syntaxe

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

Paramètres

pKey

Pointeur vers un DEVPROPKEY à ajouter à l’interface de l’appareil de caméra virtuelle. Pour plus d’informations, consultez Modèle de propriété d’appareil unifié.

Type

Type de propriété pour la pKey spécifiée. Les types DEVPROP_TYPE_NULL et DEVPROP_TYPE_EMPTY ne sont pas pris en charge.

pbData

Pointeur vers les données de propriété.

cbData

Taille en octets contenus dans la mémoire tampon pointée vers les données.

Valeur retournée

Retourne une valeur HRESULT, y compris, mais sans s’y limiter, les valeurs suivantes :

Code d'erreur	Description
S_OK	Opération réussie
E_INVALIDARG	Un paramètre d’entrée n’est pas valide.
E_ACCESSDENIED	L’appelant n’a pas les autorisations nécessaires pour ajouter des propriétés.

Remarques

Les appelants doivent disposer des autorisations au niveau de l’administrateur pour utiliser cette API. Les applications UWP et empaquetées ne disposent pas des autorisations nécessaires pour appeler cette méthode.

Les appelants doivent faire preuve de prudence lors de l’ajout de propriétés d’appareil Windows connues, car cela peut avoir des effets inattendus.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Build 22000
En-tête	mfvirtualcamera.h
Bibliothèque	mfsensorgroup.lib
DLL	mfsensorgroup.dll

Partager via