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

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

  • Статья

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

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

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

Синтаксис

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

Параметры

[out, optional] pSizeInBytes

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

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

[out, optional] pullOffset

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

Клиентские приложения указывают это значение в offset и OffsetHigh членов структуры OVERLAPPED. Указатель на OVERLAPPED передается в функции Microsoft Win32 WriteFile или WriteFileEx.

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

[out, optional] pulKey

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

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

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

Никакой

Замечания

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

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

Требования

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

См. также