Funzione MFCreateSensorGroup (mfidl.h)

Crea un'istanza dell'interfaccia IMFSensorGroup in base al nome di collegamento simbolico specificato.

Sintassi

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

Parametri

SensorGroupSymbolicLink

Collegamento simbolico per il nuovo FMSensorGroup. Questo nome può essere ottenuto tramite api di enumerazione del dispositivo, ad esempio SetupDiGetClassDevs o MFEnumDeviceSources o recuperando la proprietà Id della classe DeviceInformation .

[out] ppSensorGroup

Collegamento simbolico per il nuovo FMSensorGroup.

Valore restituito

La funzione restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	L'oggetto FMSensorGroup fornito è null.
E_INVALIDARG	LPCWSTR fornito è Null.

Commenti

Se la funzione ha esito positivo, ppSensorGroup punta a un oggetto IMFSensorGroup valido. Il chiamante deve rilasciare questa interfaccia.

Nota Quando questa API viene usata con un KSCATEGORY_SENSOR_CAMERA o KSCATEGORY_VIDEO_CAMERA nome simbolico, l'oggetto FMSensorGroup risultante conterrà solo un dispositivo sensore, ma si comporta come gruppo di sensori virtualizzati. Il chiamante può usare l'oggetto risultante nello stesso modo di un gruppo di sensori ottenuto da un KSCATEGORY_SENSOR_GROUP.

 

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1607 [app desktop | App UWP]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mfidl.h