IMFCameraControlMonitor::RemoveControlSubscription-Methode (mfidl.h)

Artikel
03/04/2024

Entfernt ein Kamerasteuerelement aus der Liste der Steuerelemente, für die IMFCameraControlNotify::OnChange-Benachrichtigungen ausgelöst werden.

Syntax

HRESULT RemoveControlSubscription(
  GUID   controlSet,
  UINT32 id
);

Parameter

controlSet

Die GUID für das Kamerasteuerelement, zu dem das hinzugefügte Steuerelement gehört.

id

Die ID des Steuerelements im Steuerelementsatz.

Rückgabewert

Ein HRESULT, das Folgendes enthält:

Wert	BESCHREIBUNG
S_OK	Erfolg
MF_E_INVALIDREQUEST	Der Kamerasteuerungsmonitor befindet sich im Zustand "Ausführung" oder "Herunterfahren".
MF_E_INVALIDARG	Für controlSet wurde ein ungültiger Wert angegeben. Weitere Informationen finden Sie unter Hinweise.
MF_E_NOT_FOUND	Für das angegebene Steuerelement wurde kein Abonnement gefunden.

Hinweise

Der Versuch, Abonnements hinzuzufügen oder zu entfernen, nachdem Start aufgerufen wurde, aber vor dem Aufrufen von Stop oder nach dem Aufrufen des Herunterfahrens aufgerufen wird, führt zu einem Fehler.

Die explizit unterstützten Steuerelemente umfassen die Eigenschaften unter PROPSETID_VIDCAP_VIDEOPROCAMP und PROPSETID_VIDCAP_CAMERACONTROL und KSPROPERTYSETID_ExtendedCameraControl. Wenn AddControlSubscription mit KSPROPERTYSETID_ANYCAMERACONTROL als controlSet-Parameter aufgerufen wird, ruft das erstellte Abonnement Rückrufe für jede Steuerelementänderung hervor, auch wenn diese außerhalb der zuvor aufgeführten Eigenschaftensätze stehen.

Das Angeben eines anderen Werts als KSPROPERTYSETID_ANYCAMERACONTROL, PROPSETID_VIDCAP_VIDEOPROCAMP, PROPSETID_VIDCAP_CAMERACONTROL oder KSPROPERTYSETID_ExtendedCameraControl führt zu einem Fehler.

Ein Codebeispiel, das diese Methode implementiert, finden Sie unter IMFCameraControlNotify.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 11 Build 22621
Unterstützte Mindestversion (Server)	Windows 11 Build 22621
Kopfzeile	mfidl.h
Bibliothek	mfsensorgroup.lib
DLL	mfsensorgroup.dll

Freigeben über