Partager via


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
);

Paramètres

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.

Valeur retournée

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.

Remarques

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.
 

Configuration requise

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