Función MFCreateSensorGroup (mfidl.h)

  • Artículo

Crea una instancia de la interfaz IMFSensorGroup basada en el nombre de vínculo simbólico proporcionado.

Sintaxis

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

Parámetros

SensorGroupSymbolicLink

Vínculo simbólico para el nuevo IMFSensorGroup. Este nombre se puede obtener mediante las API de enumeración de dispositivos, como SetupDiGetClassDevs o MFEnumDeviceSources o obteniendo la propiedad Id de la clase DeviceInformation .

[out] ppSensorGroup

Vínculo simbólico para el nuevo IMFSensorGroup.

Valor devuelto

La función devuelve un VALOR HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 El método se ha llevado a cabo de forma correcta.
E_POINTER
 El IMFSensorGroup proporcionado es null.
E_INVALIDARG
 El LPCWSTR proporcionado es null.

Comentarios

Si la función se realiza correctamente, ppSensorGroup apuntará a un objeto IMFSensorGroup válido. El autor de la llamada debe liberar esta interfaz.

Nota Cuando esta API se usa con un nombre simbólico KSCATEGORY_SENSOR_CAMERA o KSCATEGORY_VIDEO_CAMERA , el objeto IMFSensorGroup resultante solo contendrá un dispositivo de sensor, pero se comportará como un grupo de sensores virtualizado. El autor de la llamada puede usar el objeto resultante de la misma manera que un grupo de sensores obtenido de un KSCATEGORY_SENSOR_GROUP.
 

Requisitos

Requisito Value
Cliente mínimo compatible Windows 10, versión 1607 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado mfidl.h