IQueueCallbackRead::OnRead-Methode (wudfddi.h)

Artikel
03/01/2024

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 in neueren Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die OnRead-Methode wird aufgerufen, um eine Leseanforderung zu verarbeiten, wenn eine Anwendung Informationen von einem Gerät über die Microsoft Win32 ReadFile - oder ReadFileEx-Funktion liest.

Syntax

void OnRead(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] SIZE_T        NumOfBytesToRead
);

Parameter

[in] pWdfQueue

Ein Zeiger auf die IWDFIoQueue-Schnittstelle für das E/A-Warteschlangenobjekt, von dem die Anforderung empfangen wird.

[in] pWdfRequest

Ein Zeiger auf die IWDFIoRequest-Schnittstelle , die das Frameworkanforderungsobjekt darstellt.

[in] NumOfBytesToRead

Die Größe des Lesepuffers für die Anforderung in Bytes.

Rückgabewert

Keine

Bemerkungen

Ein Treiber registriert die IQueueCallbackRead-Schnittstelle , wenn der Treiber die IWDFDevice::CreateIoQueue-Methode aufruft , um eine E/A-Warteschlange zu erstellen oder die Standard-E/A-Warteschlange zu konfigurieren.

Ein Treiber kann eine einzelne OnRead-Methode für alle E/A-Warteschlangen oder separate OnRead-Methoden für jede E/A-Warteschlange implementieren.

Die OnRead-Methode empfängt jeden Leseanforderungstyp aus der Warteschlange. (Der Typ der Leseanforderung wird durch den WdfRequestRead-Wert des WDF_REQUEST_TYPE Enumerationstyps für die Anforderung identifiziert.) Die OnRead-Methode muss jede empfangene Leseanforderung verarbeiten. Weitere Informationen zur Verarbeitung von E/A-Anforderungen durch UMDF-Treiber finden Sie unter Verarbeiten von E/A-Anforderungen.

Der Treiber kann die Methoden IWDFIoRequest::GetReadParameters und IWDFIoRequest::GetOutputMemory aufrufen, um Informationen zur Anforderung und zum Lesepuffer abzurufen.