Metodo IMFCameraControlMonitor::AddControlSubscription (mfidl.h)

Articolo
03/05/2024

Aggiunge un controllo fotocamera all'elenco dei controlli per i quali verranno generate notifiche FMCameraControlNotify::OnChange .

Sintassi

HRESULT AddControlSubscription(
  GUID   controlSet,
  UINT32 id
);

Parametri

controlSet

GUID per il controllo fotocamera impostato su cui appartiene il controllo aggiunto.

id

ID del controllo all'interno del set di controlli.

Valore restituito

HRESULT include quanto segue:

Valore	Descrizione
S_OK	Operazione riuscita
MF_E_INVALIDREQUEST	Il monitoraggio del controllo della fotocamera si trova nello stato di esecuzione o arresto.
MF_E_INVALIDARG	Per controlSet è stato fornito un valore non valido. Per ulteriori informazioni, vedere la sezione Osservazioni.

Commenti

Il tentativo di aggiungere o rimuovere sottoscrizioni dopo aver chiamato Start , ma prima di chiamare Stop o dopo la chiamata di Arresto, genera un errore.

I controlli supportati in modo esplicito includono le proprietà in PROPSETID_VIDCAP_VIDEOPROCAMP e PROPSETID_VIDCAP_CAMERACONTROL e KSPROPERTYSETID_ExtendedCameraControl. Se AddControlSubscription viene chiamato con KSPROPERTYSETID_ANYCAMERACONTROL come parametro controlSet , la sottoscrizione creata provocherà callback per qualsiasi modifica del controllo, anche quelli esterni ai set di proprietà elencati in precedenza.

Se si specifica un valore diverso da KSPROPERTYSETID_ANYCAMERACONTROL, PROPSETID_VIDCAP_VIDEOPROCAMP, PROPSETID_VIDCAP_CAMERACONTROL o KSPROPERTYSETID_ExtendedCameraControl verrà generato un errore.

Per visualizzare un esempio di codice che implementa questo metodo, vedere FMCameraControlNotify.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 11 Build 22621
Server minimo supportato	Windows 11 Build 22621
Intestazione	mfidl.h
Libreria	mfsensorgroup.lib
DLL	mfsensorgroup.dll

Condividi tramite