IWDFIoTarget::FormatRequestForRead-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 für neuere 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 FormatRequestForRead-Methode formatiert ein E/A-Anforderungsobjekt für einen Lesevorgang.
Syntax
HRESULT FormatRequestForRead(
[in] IWDFIoRequest *pRequest,
[in, optional] IWDFFile *pFile,
[in, optional] IWDFMemory *pOutputMemory,
[in, optional] PWDFMEMORY_OFFSET pOutputMemoryOffset,
[in, optional] PLONGLONG DeviceOffset
);
Parameter
[in] pRequest
Ein Zeiger auf die IWDFIoRequest-Schnittstelle , um das Anforderungsobjekt zu formatieren.
[in, optional] pFile
Ein Zeiger auf die IWDFFile-Schnittstelle für das Dateiobjekt, das der Leseanforderung zugeordnet ist. Für das Standard-E/A-Ziel muss dieser Parameter nicht NULL sein.
[in, optional] pOutputMemory
Ein Zeiger auf die IWDFMemory-Schnittstelle , die für den Zugriff auf den Puffer verwendet wird, der für die Leseanforderung verwendet wird. Dieser Parameter ist optional.
[in, optional] pOutputMemoryOffset
Ein Zeiger auf eine WDFMEMORY_OFFSET Struktur, die den Ausgabespeicheroffset beschreibt, der für den Lesevorgang verwendet wird. Dieser Parameter ist optional.
[in, optional] DeviceOffset
Ein Zeiger auf den Geräteoffset, der für den Lesevorgang verwendet wird. Dieser Parameter ist optional.
Rückgabewert
FormatRequestForRead 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 |