Funzione VhfCreate (vhf.h)

Articolo
02/29/2024

Il driver di origine HID chiama questo metodo per creare un dispositivo HID virtuale.

Sintassi

NTSTATUS VhfCreate(
  [in]  PVHF_CONFIG VhfConfig,
  [out] VHFHANDLE   *VhfHandle
);

Parametri

[in] VhfConfig

Puntatore a una struttura VHF_CONFIG .

[out] VhfHandle

Handle per il nuovo dispositivo HID virtuale.

Valore restituito

Se la chiamata VhfCreate ha esito positivo, il metodo restituisce STATUS_SUCCESS. In caso contrario, un valore NTSTATUS appropriato.

Commenti

Questo metodo restituisce in modo sincrono dopo la convalida della struttura VHF_CONFIG e la creazione di un dispositivo HID virtuale. Il dispositivo HID virtuale viene segnalato solo a PnP. L'inizializzazione, l'installazione e l'avvio del dispositivo potrebbero non essere completati prima che questo metodo venga restituito.

Un driver Kernel-Mode Driver Framework (KMDF) può chiamare VhfCreate in qualsiasi momento dopo aver creato correttamente il proprio oggetto dispositivo chiamando WdfDeviceCreate. Il driver può farlo nel suo EvtDriverDeviceAdd, EvtDevicePrepareHardware, EvtDeviceD0Entry, EvtDeviceSelfManagedIoInit.

VHF non richiama alcuna funzione di callback specificata in VHF_CONFIG finché il driver di origine HID chiama VhfStart.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	vhf.h
Libreria	VhfKm.lib
IRQL	PASSIVE_LEVEL

Vedi anche

Scrivere un driver di origine HID usando Virtual HID Framework (VHF)

Condividi tramite