IWDFIoTarget::FormatRequestForIoctl-Methode (wudfddi.h)

Artikel
02/07/2025

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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-Steuerungsvorgang.

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 für das zu formatierende Anforderungsobjekt.

[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

Anforderung	Wert
Ende des Supports	In UMDF 2.0 und höher nicht verfügbar.
Zielplattform-	Desktop
Mindest-UMDF-Version	1.5
Header-	wudfddi.h (include Wudfddi.h)
DLL-	WUDFx.dll

Siehe auch

Freigeben über