IQueueCallbackWrite::OnWrite-Methode (wudfddi.h)

Artikel
02/07/2025

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

Die OnWrite--Methode wird aufgerufen, um eine Schreibanforderung zu verarbeiten, wenn eine Anwendung Informationen über die Microsoft Win32-WriteFile-- oder WriteFileEx--Funktion auf ein Gerät schreibt.

Syntax

void OnWrite(
  [in] IWDFIoQueue   *pWdfQueue,
  [in] IWDFIoRequest *pWdfRequest,
  [in] SIZE_T        NumOfBytesToWrite
);

Parameter

[in] pWdfQueue

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

[in] pWdfRequest

Ein Zeiger auf die IWDFIoRequest Schnittstelle, die das Framework-Anforderungsobjekt darstellt.

[in] NumOfBytesToWrite

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

Rückgabewert

Nichts

Bemerkungen

Ein Treiber registriert die IQueueCallbackWrite 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 OnWrite--Methode für alle E/A-Warteschlangen oder separate OnWrite- Methoden für jede E/A-Warteschlange implementieren.

Die OnWrite--Methode empfängt jeden Schreibanforderungstyp aus der Warteschlange. (Der Schreibanforderungstyp wird durch den WdfRequestWrite Wert des WDF_REQUEST_TYPE Enumerationstyps für die Anforderung identifiziert.) Die OnWrite--Methode muss jede empfangene Schreibanforderung verarbeiten. Weitere Informationen dazu, wie UMDF-Treiber E/A-Anforderungen verarbeiten, finden Sie unter Verarbeiten von E/A-Anforderungen.

Der Treiber kann die IWDFIoRequest::GetWriteParameters und IWDFIoRequest::GetInputMemory- Methoden aufrufen, um Informationen über die Anforderung und den Schreibpuffer abzurufen.