Partager via


IMFCameraControlDefaultsCollection ::GetOrAddControl, méthode (mfidl.h)

Ajoute un nouveau contrôle de caméra à la collection de contrôles de caméra.

Syntaxe

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

Paramètres

configType

Valeur de l'MF_CAMERA_CONTROL_CONFIGURATION_TYPE spécifiant si la valeur de contrôle doit être définie avant le début de la diffusion en continu ou après le démarrage de la diffusion en continu.

controlSet

GUID spécifiant le jeu de contrôles auquel appartient le contrôle. Si le controlSet de est KSPROPERTYSETID_ExtendedCameraControl utilisez la fonction GetOrAddExtendedControl dédiée.

constrolId

ID du contrôle à ajouter à la collection.

controlSize

Taille du contrôle, en octets. Cette valeur doit être supérieure ou égale à la taille de KSPROPERTY.

dataSize

Taille de la charge utile de données pour le contrôle, en octets.

defaults

Reçoit un pointeur vers une instance IMFCameraControlDefaults représentant le contrôle ajouté.

Valeur de retour

HRESULT, y compris les éléments suivants :

Valeur Description
S_OK Succès.

Remarques

Pour les contrôles personnalisés, controlSet et controlId sont basés sur le contrôle personnalisé DDI publié par le fournisseur du pilote de caméra. De même, les controlSize et dataSize sont basés sur la DDI publiée par le fournisseur.

Exigences

Exigence Valeur
client minimum pris en charge Windows 11 Build 22621
serveur minimum pris en charge Windows 11 Build 22621
d’en-tête mfidl.h