MFCreateSensorGroup-Funktion (mfidl.h)

Artikel
02/28/2024

Erstellt eine instance der IMFSensorGroup-Schnittstelle basierend auf dem angegebenen symbolischen Linknamen.

Syntax

HRESULT MFCreateSensorGroup(
        LPCWSTR        SensorGroupSymbolicLink,
  [out] IMFSensorGroup **ppSensorGroup
);

Parameter

SensorGroupSymbolicLink

Die symbolische Verknüpfung für die neue IMFSensorGroup. Dieser Name kann über Geräteaufzählungs-APIs wie SetupDiGetClassDevs oder MFEnumDeviceSources oder durch Abrufen der Id-Eigenschaft der DeviceInformation-Klasse abgerufen werden.

[out] ppSensorGroup

Die symbolische Verknüpfung für die neue IMFSensorGroup.

Rückgabewert

Die Funktion gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Die angegebene IMFSensorGroup ist NULL.
E_INVALIDARG	Der angegebene LPCWSTR ist NULL.

Hinweise

Wenn die Funktion erfolgreich ist, zeigt ppSensorGroup auf ein gültiges IMFSensorGroup-Objekt . Der Aufrufer muss diese Schnittstelle freigeben.

Hinweis Wenn diese API mit einem KSCATEGORY_SENSOR_CAMERA oder KSCATEGORY_VIDEO_CAMERA symbolischen Namen verwendet wird, enthält das resultierende IMFSensorGroup-Objekt nur ein Sensorgerät, verhält sich aber als virtualisierte Sensorgruppe. Der Aufrufer kann das resultierende Objekt auf die gleiche Weise wie eine Sensorgruppe verwenden, die von einer KSCATEGORY_SENSOR_GROUP abgerufen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1607 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	mfidl.h

Freigeben über