Metodo IWDFIoTarget::FormatRequestForRead (wudfddi.h)

Articolo
02/27/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. 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