FLT_PARAMETERS per l'unione IRP_MJ_MDL_READ

Articolo
02/02/2024

Il componente di unione seguente viene usato quando il campo MajorFunction della struttura FLT_IO_PARAMETER_BLOCK per l'operazione è IRP_MJ_MDL_READ.

Sintassi

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    LARGE_INTEGER           FileOffset;
    ULONG POINTER_ALIGNMENT Length;
    ULONG POINTER_ALIGNMENT Key;
    PMDL                    *MdlChain;
  } MdlRead;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Members

MdlRead: struttura contenente i membri seguenti.
FileOffset: Avvio di byte all'interno del file memorizzato nella cache.
Lunghezza: lunghezza, in byte, dei dati da leggere dal file memorizzato nella cache.
Chiave: valore chiave associato a un blocco di intervallo byte nel file di destinazione. Se l'intervallo da leggere si sovrappone o è una sottorange di un intervallo bloccato esclusivamente all'interno del file, questo parametro deve essere la chiave per tale blocco esclusivo. Il blocco esclusivo deve essere mantenuto dal processo padre del thread chiamante; in caso contrario, questo parametro viene ignorato.
MdlChain: puntatore a una variabile che riceve un puntatore a una catena di uno o più elenchi di descrittori di memoria (MDL) che descrivono le pagine contenenti i dati da leggere.

Commenti

La struttura FLT_PARAMETERS per le operazioni di IRP_MJ_MDL_READ contiene i parametri per un'operazione MdlRead di I/O veloce rappresentata da una struttura di callback (FLT_CALLBACK_DATA). È contenuta in una struttura di FLT_IO_PARAMETER_BLOCK.

Se una richiesta di I/O rapida IRP_MJ_MDL_READ ha esito negativo, l'autorità emittente dell'I/O determina come riemettere la richiesta. Un minifilter potrebbe non sempre ottenere un IRP_MJ_MDL_READ basato su IRP. Ad esempio, la richiesta IRP può essere ristampata come IRP_MJ_READ/IRP_MN_MDL.

IRP_MJ_MDL_READ è un'operazione di I/O veloce.