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

Article
02/28/2024

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

Syntaxe

HRESULT RemoveControlSubscription(
  GUID   controlSet,
  UINT32 id
);

Paramètres

controlSet

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

id

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

Valeur retournée

Un HRESULT incluant les éléments suivants :

Valeur	Description
S_OK	Succès
MF_E_INVALIDREQUEST	Le moniteur de contrôle de la caméra est à l’état d’exécution ou d’arrêt.
MF_E_INVALIDARG	Une valeur non valide a été fournie pour controlSet. Pour plus d'informations, consultez la section Notes.
MF_E_NOT_FOUND	Aucun abonnement n’a été trouvé pour le contrôle spécifié.

Remarques

Toute 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, génère une erreur.

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

La spécification d’une valeur autre que KSPROPERTYSETID_ANYCAMERACONTROL, PROPSETID_VIDCAP_VIDEOPROCAMP, PROPSETID_VIDCAP_CAMERACONTROL ou KSPROPERTYSETID_ExtendedCameraControl génère une erreur.

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

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
Bibliothèque	mfsensorgroup.lib
DLL	mfsensorgroup.dll

Partager via