IWDFIoTarget::FormatRequestForWrite-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 FormatRequestForWrite-Methode formatiert ein E/A-Anforderungsobjekt für einen Schreibvorgang.
Syntax
HRESULT FormatRequestForWrite(
[in] IWDFIoRequest *pRequest,
[in, optional] IWDFFile *pFile,
[in, optional] IWDFMemory *pInputMemory,
[in, optional] PWDFMEMORY_OFFSET pInputMemoryOffset,
[in, optional] PLONGLONG DeviceOffset
);
Parameter
[in] pRequest
Ein Zeiger auf die IWDFIoRequest-Schnittstelle für das zu formatierende Anforderungsobjekt.
[in, optional] pFile
Ein Zeiger auf die IWDFFile-Schnittstelle für das Dateiobjekt, das der Schreibanforderung zugeordnet ist. Für das Standard-E/A-Ziel muss dieser Parameter nicht NULL sein.
[in, optional] pInputMemory
Ein Zeiger auf die IWDFMemory-Schnittstelle , die für den Zugriff auf den Puffer verwendet wird, der für die Schreibanforderung verwendet wird. Dieser Parameter ist optional.
[in, optional] pInputMemoryOffset
Ein Zeiger auf eine WDFMEMORY_OFFSET-Struktur , die den Eingabespeicheroffset beschreibt, der für die Schreibanforderung verwendet wird. Dieser Parameter ist optional.
[in, optional] DeviceOffset
Ein Zeiger auf den Geräteoffset, der für die Schreibanforderung verwendet wird. Dieser Parameter ist optional.
Rückgabewert
FormatRequestForWrite gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform | Desktop |
| UMDF-Mindestversion | 1.5 |
| Kopfzeile | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |