Condividi tramite


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