Condividi tramite


Metodo IWDFIoTarget::FormatRequestForRead (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. Nessuna nuova funzionalità viene aggiunta 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 informazioni, vedere Introduzione con UMDF.]

Il metodo FormatRequestForRead formatta un oggetto richiesta I/O per un'operazione di lettura.

Sintassi

HRESULT FormatRequestForRead(
  [in]           IWDFIoRequest     *pRequest,
  [in, optional] IWDFFile          *pFile,
  [in, optional] IWDFMemory        *pOutputMemory,
  [in, optional] PWDFMEMORY_OFFSET pOutputMemoryOffset,
  [in, optional] PLONGLONG         DeviceOffset
);

Parametri

[in] pRequest

Puntatore all'interfaccia IWDFIoRequest per il formato dell'oggetto request.

[in, optional] pFile

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

[in, optional] pOutputMemory

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

[in, optional] pOutputMemoryOffset

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

[in, optional] DeviceOffset

Puntatore all'offset del dispositivo usato per la lettura. Questo parametro è facoltativo e,

Valore restituito

FormatRequestForRead 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

IWDFFile

IWDFIoRequest

IWDFIoTarget

IWDFMemory

WDFMEMORY_OFFSET