MFCreateSensorGroup-Funktion (mfidl.h)

Artikel
03/05/2025

Erstellt eine Instanz der IMFSensorGroup Schnittstelle basierend auf dem bereitgestellten symbolischen Verknüpfungsnamen.

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 abgerufen werden, oder indem die eigenschaft ID der DeviceInformation Klasse abgerufen wird.

[out] ppSensorGroup

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

Rückgabewert

Die Funktion gibt eine HRESULT-zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
E_POINTER	Die bereitgestellte IMFSensorGroup- null ist.
E_INVALIDARG	Der angegebene LPCWSTR- ist null.

Bemerkungen

Wenn die Funktion erfolgreich ist, verweist 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 aus einem KSCATEGORY_SENSOR_GROUPabgerufen wird.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 10, Version 1607 [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Keine unterstützt
Zielplattform-	Fenster
Header-	mfidl.h

Freigeben über