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

Метод 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, если он не требует сведений.

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

Никакой

Замечания

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

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

Хотя драйвер может дополнительно указать NULL для каждого pSizeInBytes, pullOffsetи pulKey параметров, драйвер должен указать по крайней мере один параметрNULL для успешного выполнения GetReadParameter s.

Требования

Требование Ценность
завершение поддержки Недоступно в UMDF 2.0 и более поздних версиях.
целевая платформа Настольный
минимальная версия UMDF 1.5
заголовка wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

См. также