Метод IWDFIoTarget::FormatRequestForRead (wudfddi.h)
[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]
Метод FormatRequestForRead форматирует объект запроса ввода-вывода для операции чтения.
Синтаксис
HRESULT FormatRequestForRead(
[in] IWDFIoRequest *pRequest,
[in, optional] IWDFFile *pFile,
[in, optional] IWDFMemory *pOutputMemory,
[in, optional] PWDFMEMORY_OFFSET pOutputMemoryOffset,
[in, optional] PLONGLONG DeviceOffset
);
Параметры
[in] pRequest
Указатель на интерфейс IWDFIoRequest для форматирования объекта запроса.
[in, optional] pFile
Указатель на интерфейс IWDFFile для объекта файла, связанного с запросом на чтение. Для целевого объекта ввода-вывода по умолчанию этот параметр должен иметь значение, отличное от NULL.
[in, optional] pOutputMemory
Указатель на интерфейс IWDFMemory, используемый для доступа к буферу, используемому для запроса на чтение. Этот параметр является необязательным.
[in, optional] pOutputMemoryOffset
Указатель на структуру WDFMEMORY_OFFSET , описывающую смещение выходной памяти, используемое для чтения. Этот параметр является необязательным.
[in, optional] DeviceOffset
Указатель на смещение устройства, используемое для чтения. Этот параметр является необязательным.
Возвращаемое значение
FormatRequestForRead возвращает S_OK, если операция выполнена успешно. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.
Требования
Требование | Значение |
---|---|
Дата окончания поддержки | Недоступно в UMDF 2.0 и более поздних версиях. |
Целевая платформа | Персональный компьютер |
Минимальная версия UMDF | 1.5 |
Верхняя часть | wudfddi.h (включая Wudfddi.h) |
DLL | WUDFx.dll |