VhfReadReportSubmit-Funktion (vhf.h)

  • Artikel

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 für ein virtuelles HID-Gerät, das Ihr HID-Quelltreiber im vorherigen Aufruf von VhfCreate empfangen 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 .

Hinweise

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

Wenn der Treiber eine eigene Pufferrichtlinie verwendet, muss er eine EvtVhfReadyForNextReadReport-Rückruffunktion in seinem Aufruf von VhfCreate implementieren und registrieren. VhfReadReportSubmit darf nur einmal aufgerufen werden, nachdem VHF EvtVhfReadyForNextReadReport aufgerufen hat. Nachdem der Rückruf aufgerufen wurde, kann der Treiber den Übertragungspuffer wiederverwenden, auf den hidTransferPacket verweist. Der Treiber muss warten, bis VHF evtVhfReadyForNextReadReport das nächste Mal aufruft, bevor er diese Methode erneut aufruft.

Wenn der HID-Quelltreiber den EvtVhfReadyForNextReadReport-Rückruf nicht implementiert, gibt es keine Einschränkungen beim Aufrufen dieser Methode. VHF verwendet die Standardpufferungsrichtlinie. Der Treiber kann den Übertragungspuffer wiederverwenden, nachdem der Aufruf zurückgegeben wurde.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile vhf.h
Bibliothek VhfKm.lib
IRQL <= DISPATCH_LEVEL

Weitere Informationen

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