VhfCreate-Funktion (vhf.h)

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 zum neuen virtuellen HID-Gerät.

Rückgabewert

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

Bemerkungen

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 das Starten des Geräts sind möglicherweise nicht abgeschlossen, bevor diese Methode zurückgegeben wird.

Ein Kernel-Mode Driver Framework (KMDF)-Treiber kann VhfCreate jederzeit aufrufen, nachdem ein eigenes Geräteobjekt erfolgreich erstellt wurde, 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 werden, bis der HID-Quelltreiber VhfStart aufruft.

Anforderungen

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

Siehe auch

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