IWDFIoTarget::FormatRequestForIoctl-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 FormatRequestForIoctl-Methode formatiert ein E/A-Anforderungsobjekt für einen E/A-Steuerelementvorgang.

Syntax

HRESULT FormatRequestForIoctl(
  [in]           IWDFIoRequest     *pRequest,
  [in]           ULONG             IoctlCode,
  [in, optional] IWDFFile          *pFile,
  [in, optional] IWDFMemory        *pInputMemory,
  [in, optional] PWDFMEMORY_OFFSET pInputMemoryOffset,
  [in, optional] IWDFMemory        *pOutputMemory,
  [in, optional] PWDFMEMORY_OFFSET pOutputMemoryOffset
);

Parameter

[in] pRequest

Ein Zeiger auf die IWDFIoRequest-Schnittstelle , um das Anforderungsobjekt zu formatieren.

[in] IoctlCode

Ein Steuerelementcode, der einen bestimmten auszuführenden Vorgang identifiziert.

[in, optional] pFile

Ein Zeiger auf die IWDFFile-Schnittstelle für das Dateiobjekt, das der E/A-Steuerelementanforderung 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 Eingabepuffer für die Anforderung verwendet wird. Dieser Parameter ist optional.

[in, optional] pInputMemoryOffset

Ein Zeiger auf eine WDFMEMORY_OFFSET Struktur, die den Eingabespeicheroffset für die Anforderung beschreibt. Dieser Parameter ist optional.

[in, optional] pOutputMemory

Ein Zeiger auf die IWDFMemory-Schnittstelle , die für den Zugriff auf den Ausgabepuffer für die Anforderung verwendet wird. Dieser Parameter ist optional.

[in, optional] pOutputMemoryOffset

Ein Zeiger auf eine WDFMEMORY_OFFSET Struktur, die den Ausgabespeicheroffset für die Anforderung beschreibt. Dieser Parameter ist optional.

Rückgabewert

FormatRequestForIoctl 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