IQueueCallbackWrite::OnWrite-Methode (wudfddi.h)
[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 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 empfangen wird.
[in] pWdfRequest
Ein Zeiger auf die IWDFIoRequest-Schnittstelle , die das Frameworkanforderungsobjekt darstellt.
[in] NumOfBytesToWrite
Die Größe des Schreibpuffers für die Anforderung in Bytes.
Rückgabewert
Keine
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 zur Verarbeitung von E/A-Anforderungen durch UMDF-Treiber finden Sie unter Verarbeiten von E/A-Anforderungen.
Der Treiber kann die Methoden IWDFIoRequest::GetWriteParameters und IWDFIoRequest::GetInputMemory aufrufen, um Informationen zur Anforderung und zum Schreibpuffer abzurufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |