Функция ProbeForWrite (wdm.h)

Подпрограмма ProbeForWrite проверяет, действительно ли буфер пользовательского режима находится в части адресного пространства в пользовательском режиме, доступен для записи и правильно ли выровнен.

Синтаксис

void ProbeForWrite(
  [in, out] volatile VOID *Address,
  [in]      SIZE_T        Length,
  [in]      ULONG         Alignment
);

Параметры

[in, out] Address

Указывает начало буфера пользовательского режима.

[in] Length

Указывает длину буфера пользовательского режима в байтах. Дополнительные сведения см. в разделе Примечания.

[in] Alignment

Указывает требуемое выравнивание (в байтах) начала буфера пользовательского режима.

Возвращаемое значение

None

Remarks

Эта функция обычно не дает существенного преимущества по сравнению с ProbeForRead , так как надежный драйвер всегда должен быть готов к обработке изменений защиты в виртуальном адресном пространстве пользовательского режима, включая изменения защиты, которые удаляют разрешение на запись в буфер, переданный драйверу после выполнения вызова ProbeForWrite . Поскольку ProbeForWrite обращается к каждой странице в предоставленном буфере, производительность может быть снижена из-за дополнительных затрат на доступ к каждой странице, особенно если предоставленный буфер описывает большую область виртуального адресного пространства. Кроме того, так как ProbeForWrite выполняет запись на каждую страницу, один и тот же буфер может не использоваться безопасно с несколькими одновременными запросами драйвера. По этим причинам в новом коде драйвера всегда следует использовать ProbeForRead .

В следующей таблице описаны свойства каждой подпрограммы проверки буфера в режиме ядра.

Исторически сложилось так, что на некоторых процессорах, которые не учитывали разрешения только на чтение для кода в режиме ядра, существовали значимые функциональные различия между ProbeForWrite и ProbeForRead. В таких случаях операционная система ранее полагалась на ProbeForWrite, выполняющую явную возможность записи по страницам проверка. Это различие больше не имеет смысла для процессоров, поддерживаемых Windows NT 4.0 или более поздней версии.

Устаревшие примечания

Драйверы режима ядра могут использовать ProbeForWrite для проверки доступа на запись к буферам, выделенным в пространстве пользователя. Чаще всего он используется во время METHOD_NEITHER ввода-вывода для проверки буфера пользователя, на который указывает Irp-UserBuffer>.

Если указанный диапазон памяти не является допустимым диапазоном адресов в пользовательском режиме или не поддерживает запись (без доступа, только для чтения и т. д.), ProbeForWrite вызывает исключение STATUS_ACCESS_VIOLATION. Если начало диапазона адресов не выравнивается по границе байтов, заданной параметром Выравнивание, ProbeForWrite создает исключение STATUS_DATATYPE_MISALIGNMENT.

Драйверы должны вызывать ProbeForWrite внутри блока try/except . Если подпрограмма вызывает исключение, драйвер должен завершить IRP с соответствующей ошибкой. Обратите внимание, что последующие доступы драйвера к буферу пользовательского режима также должны быть инкапсулированы в блок try/except . Вредоносное приложение может иметь другой поток, удаляющий, заменяющий или изменяющий защиту диапазонов адресов пользователей в любое время (даже после или во время вызова ProbeForRead или ProbeForWrite). Дополнительные сведения см. в разделе Обработка исключений.

Не используйте эту подпрограмму для адресов в режиме ядра; он вызовет исключение.

Если Irp-RequestorMode>KernelMode = , поля Irp-AssociatedIrp.SystemBuffer> и Irp-UserBuffer> не содержат адресов в пользовательском режиме, а вызов ProbeForWrite для проверки буфера, на который указывает любое из полей, вызовет исключение.

Если length = 0, ProbeForWrite не проверяет адрес. В этом случае подпрограмма не создает исключение для адреса, который является неправильным или находится за пределами диапазона допустимых адресов пользователей.

Требования

См. также раздел

ProbeForRead