Метод IWDFIoRequest::GetInputMemory (wudfddi.h)

  • Статья

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]

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

Синтаксис

void GetInputMemory(
  [out] IWDFMemory **ppWdfMemory
);

Параметры

[out] ppWdfMemory

Указатель на переменную, которая получает указатель на интерфейс IWDFMemory с подсчетом ссылок для объекта памяти. Обратите внимание, что возвращать значение NULL является допустимым; в этом случае входная память не связана с запросом ввода-вывода.

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

None

Remarks

Драйверы, использующие метод доступа к буферизованному вводу-выводу , могут вызывать GetInputMemory для получения входного буфера запроса ввода-вывода.

Прежде чем драйвер завершит запрос ввода-вывода, драйвер должен вызвать метод IWDFMemory::Release для объекта памяти. Базовый объект памяти освобождается по завершении запроса.

Входной буфер, связанный с запросом ввода-вывода, содержит сведения (например, данные для записи на диск), предоставленные инициатором запроса. Драйвер может вызвать GetInputMemory для получения входного буфера для запроса на запись или запроса управления вводом-выводом устройства, но не для запроса на чтение (так как запросы на чтение не предоставляют входные данные). Чтобы получить доступ к входным буферам, драйвер должен вызвать метод IWDFMemory::GetDataBuffer .

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

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

Примеры

Пример кода использования метода GetInputMemory см. в разделе IWDFIoRequest::Complete.

Требования

Требование Значение
Дата окончания поддержки Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа Персональный компьютер
Минимальная версия UMDF 1.5
Верхняя часть wudfddi.h (включая Wudfddi.h)
DLL WUDFx.dll

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

IWDFIoRequest

IWDFIoRequest::Complete

IWDFMemory

IWDFMemory::GetDataBuffer