Метод 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 |