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

  • Статья

Предупреждение

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

Метод GetReadParameters извлекает параметры запроса для запроса типа чтения.

Синтаксис

void GetReadParameters(
  [out, optional] SIZE_T   *pSizeInBytes,
  [out, optional] LONGLONG *pullOffset,
  [out, optional] ULONG    *pulKey
);

Параметры

[out, optional] pSizeInBytes

Указатель на переменную, которая получает размер (в байтах) для чтения. Чтобы получить данные для чтения, драйвер вызывает метод IWDFIoRequest::GetOutputMemory .

Этот параметр является необязательным. Драйвер может передать значение NULL , если ему не требуются сведения.

[out, optional] pullOffset

Указатель на переменную, которая получает смещение (в байтах) для начала чтения с устройства или файла на устройстве. Если устройство не поддерживает абсолютные адреса чтения, pullOffset можно игнорировать. Дополнительные сведения см. в разделе "Примечания".

Клиентские приложения указывают это значение в элементах Offset и OffsetHigh структуры OVERLAPPED. Указатель на OVERLAPPED передается в функции Microsoft Win32 ReadFile или ReadFileEx .

Этот параметр является необязательным. Драйвер может передать значение NULL , если ему не требуются сведения.

[out, optional] pulKey

Указатель на переменную, получающую ключ, который драйвер может использовать для сортировки запроса ввода-вывода таким образом, который определяет драйвер.

Этот параметр является необязательным. Драйвер может передать значение NULL , если ему не требуются сведения.

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

None

Remarks

Вызов GetReadParameters завершается ошибкой, если тип запроса не является типом чтения.

Для устройств, поддерживающих адресацию (например, дискового устройства), значение, на которое указывает параметр pullOffset , обычно является смещением байтов в устройстве. Для устройств, которые не поддерживают адресацию (например, последовательный порт), драйвер может игнорировать значение pullOffset.

Хотя драйвер может дополнительно указать ЗНАЧЕНИЕ NULL для каждого из параметров pSizeInBytes, pullOffset и pulKey , драйвер должен указать по крайней мере один параметр, отличный от NULL , для успешного выполнения GetReadParameters .

Требования

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

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