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 |