Méthode IMFCameraControlMonitor ::AddControlSubscription (mfidl.h)

Ajoute un contrôle de caméra à la liste des contrôles pour lesquels les notifications IMFCameraControlNotify ::OnChange seront déclenchées.

Syntaxe

HRESULT AddControlSubscription(
  GUID   controlSet,
  UINT32 id
);

Paramètres

controlSet

GUID du jeu de contrôle de caméra auquel appartient le contrôle ajouté.

id

ID du contrôle dans le jeu de contrôles.

Valeur retournée

Un HRESULT comprenant les éléments suivants :

Remarques

La tentative d’ajout ou de suppression d’abonnements après l’appel de Start , mais avant d’appeler Stop ou après l’appel de l’arrêt, entraîne une erreur.

Les contrôles explicitement pris en charge incluent les propriétés sous PROPSETID_VIDCAP_VIDEOPROCAMP , PROPSETID_VIDCAP_CAMERACONTROL et KSPROPERTYSETID_ExtendedCameraControl. Si AddControlSubscription est appelé avec KSPROPERTYSETID_ANYCAMERACONTROL comme paramètre controlSet , l’abonnement créé provoquera des rappels pour toute modification de contrôle, même en dehors des jeux de propriétés précédemment répertoriés.

La spécification d’une valeur autre que KSPROPERTYSETID_ANYCAMERACONTROL, PROPSETID_VIDCAP_VIDEOPROCAMP, PROPSETID_VIDCAP_CAMERACONTROL ou KSPROPERTYSETID_ExtendedCameraControl entraîne une erreur.

Pour voir un exemple de code qui implémente cette méthode, consultez IMFCameraControlNotify.

Configuration requise