Metodo IWDFIoTarget::FormatRequestForIoctl (wudfddi.h)

Articolo
03/05/2024

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre info, vedi Introduzione con UMDF.]

Il metodo FormatRequestForIoctl formatta un oggetto richiesta di I/O per un'operazione di controllo I/O.

Sintassi

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
);

Parametri

[in] pRequest

Puntatore all'interfaccia IWDFIoRequest per l'oggetto richiesta da formattare.

[in] IoctlCode

Codice di controllo che identifica un'operazione specifica da eseguire.

[in, optional] pFile

Puntatore all'interfaccia IWDFFile per l'oggetto file associato alla richiesta di controllo I/O. Per la destinazione di I/O predefinita, questo parametro deve essere diverso da NULL.

[in, optional] pInputMemory

Puntatore all'interfaccia IWDFMemory usata per accedere al buffer di input per la richiesta. Questo parametro è facoltativo e,

[in, optional] pInputMemoryOffset

Puntatore a una struttura WDFMEMORY_OFFSET che descrive l'offset di memoria di input per la richiesta. Questo parametro è facoltativo e,

[in, optional] pOutputMemory

Puntatore all'interfaccia IWDFMemory usata per accedere al buffer di output per la richiesta. Questo parametro è facoltativo e,

[in, optional] pOutputMemoryOffset

Puntatore a una struttura WDFMEMORY_OFFSET che descrive l'offset di memoria di output per la richiesta. Questo parametro è facoltativo e,

Valore restituito

FormatRequestForIoctl restituisce S_OK se l'operazione ha esito positivo. In caso contrario, questo metodo restituisce uno dei codici di errore definiti in Winerror.h.

Requisiti

Requisito	Valore
Fine del supporto	Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione	Desktop
Versione UMDF minima	1.5
Intestazione	wudfddi.h (include Wudfddi.h)
DLL	WUDFx.dll

Vedi anche