VhfReadReportSubmit-Funktion (vhf.h)

Artikel
02/07/2025

Der HID-Quelltreiber ruft diese Methode auf, um einen HID-Lesebericht (Input) an Virtual HID Framework (VHF) zu übermitteln.

Syntax

NTSTATUS VhfReadReportSubmit(
  [in] VHFHANDLE        VhfHandle,
  [in] PHID_XFER_PACKET HidTransferPacket
);

Parameter

[in] VhfHandle

Ein Handle zu einem virtuellen HID-Gerät, das Ihr HID-Quelltreiber im vorherigen Aufruf von VhfCreateempfangen hat.

[in] HidTransferPacket

Ein Zeiger auf eine HID_XFER_PACKET Struktur, die den HID-Bericht beschreibt.

Rückgabewert

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

Bemerkungen

Der HID-Quelltreiber kann die Pufferrichtlinie implementieren oder virtual HID Framework (VHF) puffern lassen.

Wenn der Treiber eine eigene Pufferrichtlinie verwendet, muss er eine EvtVhfReadyForNextReadReport Rückruffunktion im Aufruf von VhfCreateimplementieren und registrieren. Sie muss VhfReadReportSubmit- nur einmal aufrufen, nachdem VHF EvtVhfReadyForNextReadReportaufgerufen hat. Nachdem der Rückruf aufgerufen wurde, kann der Treiber den Transferpuffer wiederverwenden, auf den HidTransferPacketverweist. Der Treiber muss warten, bis VHF das nächste Mal EvtVhfReadyForNextReadReport- aufruft, bevor diese Methode erneut aufgerufen wird.

Wenn der HID-Quelltreiber den EvtVhfReadyForNextReadReport Rückruf nicht implementiert, gibt es keine Einschränkungen beim Aufrufen dieser Methode. VHF verwendet die Standardpufferrichtlinie. Der Treiber kann den Übertragungspuffer nach dem Zurückgeben des Aufrufs wiederverwenden.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	vhf.h
Library	VhfKm.lib
IRQL-	<= DISPATCH_LEVEL

Siehe auch

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

Freigeben über