VhfCreate-Funktion (vhf.h)

  • Artikel

Der HID-Quelltreiber ruft diese Methode auf, um ein virtuelles HID-Gerät zu erstellen.

Syntax

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

Parameter

[in] VhfConfig

Ein Zeiger auf eine VHF_CONFIG Struktur.

[out] VhfHandle

Ein Handle für das neue virtuelle HID-Gerät.

Rückgabewert

Wenn der VhfCreate-Aufruf erfolgreich ist, gibt die Methode STATUS_SUCCESS zurück. Andernfalls ein geeigneter NTSTATUS-Wert .

Hinweise

Diese Methode gibt synchron zurück, nachdem die VHF_CONFIG-Struktur überprüft und ein virtuelles HID-Gerät erstellt wurde. Das virtuelle HID-Gerät wird nur an PnP gemeldet. Die Initialisierung, Installation und der Start des Geräts werden möglicherweise nicht abgeschlossen, bevor diese Methode zurückgegeben wird.

Ein Kernel-Mode Driver Framework (KMDF)-Treiber kann VhfCreate jederzeit aufrufen, nachdem er erfolgreich sein eigenes Geräteobjekt erstellt hat, indem WdfDeviceCreate aufgerufen wird. Der Treiber kann dies in seinem EvtDriverDeviceAdd, EvtDevicePrepareHardware, EvtDeviceD0Entry, EvtDeviceSelfManagedIoInit tun.

VHF ruft keine Rückruffunktionen auf, die in VHF_CONFIG angegeben sind, bis der HID-Quelltreiber VhfStart aufruft.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile vhf.h
Bibliothek VhfKm.lib
IRQL PASSIVE_LEVEL

Weitere Informationen

Schreiben eines HID-Quelltreibers mithilfe von Virtual HID Framework (VHF)