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

Weitere Informationen

IWDFFile

IWDFIoRequest

IWDFIoTarget

IWDFMemory

WDFMEMORY_OFFSET