FLT_PARAMETERS für IRP_MJ_SET_EA Union
Union-Komponente, die verwendet wird, wenn das Feld MajorFunction der FLT_IO_PARAMETER_BLOCK-Struktur für den Vorgang IRP_MJ_SET_EA ist.
Syntax
typedef union _FLT_PARAMETERS {
... ;
struct {
ULONG Length;
PVOID EaBuffer;
PMDL MdlAddress;
} SetEa;
... ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;
Member
SetEa: Struktur, die die folgenden Member enthält.
Länge: Länge des Puffers, auf den EaBuffer zeigt, in Bytes.
EaBuffer: Zeiger auf einen vom Aufrufer bereitgestellten , FILE_FULL_EA_INFORMATION strukturierten Eingabepuffer, der die festzulegenden WERTE des erweiterten Attributs (EA) enthält. Dieser Member ist optional und kann NULL sein, wenn eine MDL in MdlAddress bereitgestellt wird. Siehe Hinweise.
MdlAddress: Adresse einer Speicherdeskriptorliste (Memory Descriptor List, MDL), die den Puffer beschreibt, auf den EaBuffer zeigt. Dieser Member ist optional und kann NULL sein, wenn ein Puffer in EaBuffer bereitgestellt wird. Siehe Hinweise.
Hinweise
Die FLT_PARAMETERS-Struktur für IRP_MJ_SET_EA-Vorgänge enthält die Parameter für einen set-extended-attributes-information-operation, der durch eine Rückrufdatenstruktur (FLT_CALLBACK_DATA) dargestellt wird. Sie ist in einer FLT_IO_PARAMETER_BLOCK-Struktur enthalten.
Wenn sowohl ein EaBuffer - als auch ein MdlAddress-Puffer bereitgestellt werden, wird empfohlen, dass Minifilter die MDL verwenden. Der Speicher, auf den EaBuffer zeigt, ist gültig, wenn es sich um eine Benutzermodusadresse handelt, auf die im Kontext des aufrufenden Prozesses zugegriffen wird, oder wenn es sich um eine Kernelmodusadresse handelt.
Wenn ein Minifilter den Wert von MdlAddress ändert, gibt der Filter-Manager nach dem Rückruf nach dem Vorgang die derzeit in MdlAddress gespeicherte MDL frei und stellt den vorherigen Wert von MdlAddress wieder her.
IRP_MJ_SET_EA ist ein IRP-basierter Vorgang.
Anforderungen
| Anforderungstyp | Anforderung |
|---|---|
| Header | Fltkernel.h ( fltkernel.h einschließen) |