Função MFCreateSensorGroup (mfidl.h)

  • Artigo

Cria uma instância da interface IMFSensorGroup com base no nome do link simbólico fornecido.

Sintaxe

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

Parâmetros

SensorGroupSymbolicLink

O link simbólico para o novo IMFSensorGroup. Esse nome pode ser obtido por meio de APIs de enumeração de dispositivo, como SetupDiGetClassDevs ou MFEnumDeviceSources ou obtendo a propriedade Id da classe DeviceInformation .

[out] ppSensorGroup

O link simbólico para o novo IMFSensorGroup.

Retornar valor

A função retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
E_POINTER
 O IMFSensorGroup fornecido é nulo.
E_INVALIDARG
 O LPCWSTR fornecido é nulo.

Comentários

Se a função for bem-sucedida, ppSensorGroup apontará para um objeto IMFSensorGroup válido. O chamador deve liberar essa interface.

Nota Quando essa API é usada com um nome simbólico KSCATEGORY_SENSOR_CAMERA ou KSCATEGORY_VIDEO_CAMERA , o objeto IMFSensorGroup resultante conterá apenas um dispositivo de sensor, mas se comportará como um grupo de sensores virtualizado. O chamador pode usar o objeto resultante da mesma maneira que um grupo de sensores obtido de um KSCATEGORY_SENSOR_GROUP.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 1607 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho mfidl.h