Функция WdfRequestRetrieveUnsafeUserOutputBuffer (wdfrequest.h)

Статья
02/27/2024

[Применяется только к KMDF]

Метод WdfRequestRetrieveUnsafeUserOutputBuffer извлекает выходной буфер запроса ввода-вывода, если метод запроса для доступа к буферам данных не является ни буферизованным, ни прямым вводом-выводом.

Синтаксис

NTSTATUS WdfRequestRetrieveUnsafeUserOutputBuffer(
  [in]            WDFREQUEST Request,
  [in]            size_t     MinimumRequiredLength,
  [out]           PVOID      *OutputBuffer,
  [out, optional] size_t     *Length
);

Параметры

[in] Request

Дескриптор объекта запроса платформы.

[in] MinimumRequiredLength

Минимальный размер буфера (в байтах), необходимый драйверу для обработки запроса ввода-вывода.

[out] OutputBuffer

Указатель на расположение, которое получает адрес буфера.

[out, optional] Length

Указатель на расположение, которое получает размер буфера в байтах. Этот параметр является необязательным и может иметь значение NULL.

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

WdfRequestRetrieveUnsafeUserOutputBuffer возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае этот метод может вернуть одно из следующих значений:

Код возврата	Описание
STATUS_INVALID_PARAMETER	Входной параметр недопустим.
STATUS_INVALID_DEVICE_REQUEST	Это значение возвращается, если происходит одно из следующих действий: Метод не был вызван из функции обратного вызова EvtIoInCallerContext драйвера. Код элемента управления ввода-вывода запроса ввода-вывода IRP_MJ_WRITE или IRP_MJ_INTERNAL_DEVICE_CONTROL. Запрос указывает буферизованное или прямое ввод-вывод.
STATUS_BUFFER_TOO_SMALL	Параметр MinimumRequiredLength указывает размер буфера, превышающий фактический размер буфера.

Этот метод также может возвращать другие значения NTSTATUS.

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

Метод WdfRequestRetrieveUnsafeUserOutputBuffer должен вызываться из функции обратного вызова EvtIoInCallerContext . После вызова WdfRequestRetrieveUnsafeUserOutputBuffer драйвер должен вызвать WdfRequestProbeAndLockUserBufferForWrite.

Драйвер может вызывать WdfRequestRetrieveUnsafeUserOutputBuffer , если код элемента управления вводом-выводом запроса IRP_MJ_READ или IRP_MJ_DEVICE_CONTROL.

Драйвер может получить доступ к полученному буферу, пока не завершит запрос ввода-вывода , который представляет параметр Request .

Дополнительные сведения о WdfRequestRetrieveUnsafeUserOutputBuffer см. в статье Доступ к буферам данных в драйверах Framework-Based.

Примеры

Пример кода, в котором используется WdfRequestRetrieveUnsafeUserOutputBuffer, см. в разделе WdfRequestProbeAndLockUserBufferForRead.

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Верхняя часть	wdfrequest.h (включая Wdf.h)
Библиотека	Wdf01000.sys (см. раздел Управление версиями библиотеки платформы).
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	BufAfterReqCompletedIntIoctl(kmdf), BufAfterReqCompletedIntIoctlA(kmdf), BufAfterReqCompletedIoctl(kmdf), BufAfterReqCompletedIoctlA(kmdf), BufAfterReqCompletedRead(kmdf), BufAfterReqCompletedReadA(kmdf), BufAfterReqCompletedWrite(kmdf), DriverCreate(kmdf), InvalidReqAccess(kmdf), InvalidReqAccessLocal(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), OutputBufferAPI(kmdf)

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

EvtIoInCallerContext

WdfRequestProbeAndLockUserBufferForWrite

WdfRequestRetrieveUnsafeUserInputBuffer

Поделиться через