Metodo IWDFIoTarget::FormatRequestForIoctl (wudfddi.h)

[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

Vedi anche

IWDFFile

IWDFIoRequest

IWDFIoTarget

IWDFMemory

WDFMEMORY_OFFSET