Funzione VhfCreate (vhf.h)

Articolo
02/07/2025

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.

Osservazioni

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 EvtDriverDeviceAdd, EvtDevicePrepareHardware, EvtDeviceD0Entry, EvtDeviceSelfManagedIoInit.

VHF non richiama funzioni di callback specificate in VHF_CONFIG finché il driver di origine HID non chiama VhfStart.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	vhf.h
libreria	VhfKm.lib
IRQL	PASSIVE_LEVEL

Vedere anche

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

Condividi tramite