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

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

None

Remarks

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

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

Требования

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

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