IWDFIoTarget::FormatRequestForRead-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 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

Weitere Informationen