Méthode IMFCameraControlDefaultsCollection ::GetOrAddExtendedControl (mfidl.h)

Article
02/28/2024

Ajoute un nouveau contrôle d’appareil photo étendu à la collection de contrôles de caméra.

Syntaxe

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

Paramètres

[in] configType

Valeur du 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ébut de la diffusion en continu.

[in] constrolId

ID du contrôle à ajouter à la collection. Cette valeur doit être un ID dans le jeu de propriétés KSPROPERTYSETID_ExtendedCameraControl .

[in] streamId

ID du flux associé au contrôle. Ce paramater est utilisé uniquement pour les contrôles au niveau de l’épingle. Sinon, cette valeur est ignorée.

[in] dataSize

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

[out] defaults

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

Valeur retournée

Un HRESULT, y compris les éléments suivants :

Valeur	Description
S_OK	Réussite.
MF_E_INVALIDREQUEST	L’ID de contrôle spécifié ne figure pas dans le jeu de propriétés KSPROPERTYSETID_ExtendedCameraControl.

Remarques

La taille de la charge utile des données peut varier selon les contrôles. La valeur dataSize doit être valide pour le schéma de charge utile de contrôle afin que le contrôle puisse réserver la mémoire tampon requise.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 11 Build 22621
Serveur minimal pris en charge	Windows 11 Build 22621
En-tête	mfidl.h

Partager via