FLT_PARAMETERS для объединения IRP_MJ_WRITE

Статья
06/19/2024

Следующий компонент объединения используется, когда поле MajorFunction структуры FLT_IO_PARAMETER_BLOCK для операции IRP_MJ_WRITE .

Синтаксис

typedef union _FLT_PARAMETERS {
  ...    ;
  struct {
    ULONG         Length;
    ULONG         Key;
    LARGE_INTEGER ByteOffset;
    PVOID         WriteBuffer;
    PMDL          MdlAddress;
  } Write;
  ...    ;
} FLT_PARAMETERS, *PFLT_PARAMETERS;

Участники

Запись: структура, содержащая следующие элементы.
Длина: длина( в байтах) записываемых данных.
Ключ: значение ключа, связанное с блокировкой диапазона байтов в целевом файле.
ByteOffset: начальная смещение байтов в файле записываемых данных.
WriteBuffer: указатель на буфер, содержащий данные для записи в файл. Этот элемент является необязательным и может иметь значение NULL, если MDL предоставляется в MdlAddress. См. Примечания.
MdlAddress: адрес списка дескрипторов памяти (MDL), описывающий буфер, на который указывает член WriteBuffer . Этот элемент является необязательным и может иметь значение NULL , если буфер указан в WriteBuffer. См. Примечания.

Замечания

Структура FLT_PARAMETERS для операций IRP_MJ_WRITE содержит параметры для операции записи, представленной структурой данных обратного вызова (FLT_CALLBACK_DATA). Он содержится в FLT_IO_PARAMETER_BLOCK структуре.

Если предоставляется буфер WriteBuffer и MdlAddress, рекомендуется использовать минифильтры MDL. Память, на которую указывает WriteBuffer , является допустимой, если он является адресом пользовательского режима, доступ к которому осуществляется в контексте вызывающего процесса, или если он является адресом режима ядра.

Если мини-фильтр изменяет значение MdlAddress, то после обратного вызова после операции диспетчер фильтров освобождает MDL, хранящийся в MdlAddress, и восстановит предыдущее значение MdlAddress.

Если бит IRP_MN_COMPLETE задан в Iopb-MinorFunction>, то MdlAddress — это адрес для отправки в CcMdlReadComplete.

Если в Iopb-MinorFunction> установлен IRP_MN_MDL бит (а не IRP_MN_COMPLETE бит), то MdlAddress — это адрес для отправки в CcPrepareMdlWrite.

IRP_MJ_WRITE может быть операцией на основе IRP или быстрой операцией ввода-вывода.