MFCreateSensorGroup-Funktion (mfidl.h)

  • Artikel

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