Fonction MFCreateSensorGroup (mfidl.h)

Crée une instance de l’interface IMFSensorGroup en fonction du nom de lien symbolique fourni.

Syntaxe

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

SensorGroupSymbolicLink

Lien symbolique du nouveau IMFSensorGroup. Ce nom peut être obtenu via des API d’énumération d’appareil telles que SetupDiGetClassDevs ou MFEnumDeviceSources ou en obtenant la propriété Id de la classe DeviceInformation .

[out] ppSensorGroup

Lien symbolique du nouveau IMFSensorGroup.

La fonction retourne un HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
E_POINTER	La valeur IMFSensorGroup fournie est null.
E_INVALIDARG	La LPCWSTR fournie est null.

Si la fonction réussit, ppSensorGroup pointe vers un objet IMFSensorGroup valide. L’appelant doit libérer cette interface.

Note Lorsque cette API est utilisée avec un nom symbolique KSCATEGORY_SENSOR_CAMERA ou KSCATEGORY_VIDEO_CAMERA , l’objet IMFSensorGroup résultant ne contient qu’un seul appareil de capteur, mais se comporte comme un groupe de capteurs virtualisé. L’appelant peut utiliser l’objet résultant de la même manière qu’un groupe de capteurs obtenu à partir d’un KSCATEGORY_SENSOR_GROUP.

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1607 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	mfidl.h