Метод IWDFDevice2::GetDeviceStackIoTypePreference (wudfddi.h)

Статья
02/07/2025

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

Метод GetDeviceStackIoTypePreference извлекает методы доступа к буферу, которые платформа использует для устройства.

Синтаксис

void GetDeviceStackIoTypePreference(
  [out] WDF_DEVICE_IO_TYPE *ReadWritePreference,
  [out] WDF_DEVICE_IO_TYPE *IoControlPreference
);

Параметры

[out] ReadWritePreference

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

[out] IoControlPreference

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

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

Никакой

Замечания

Если драйвер вызывает GetDeviceStackIoTypePreference, прежде чем диспетчер PnP загрузил все драйверы устройства, значения, которые GetDeviceStackIoTypePreference могут не быть значениями, которые он фактически использует.

Дополнительные сведения о том, как платформа выбирает метод доступа к буферу, см. в статье Как UMDF выбирает метод доступа к буферу для запроса ввода-вывода.

Примеры

В следующем примере кода извлекаются методы доступа к буферу, которые платформа использует для устройства.

WDF_DEVICE_IO_TYPE ReadWriteAccessMethod;
WDF_DEVICE_IO_TYPE IoControlAccessMethod;

Device2->GetDeviceStackIoTypePreference(&ReadWriteAccessMethod,
                                        &IoControlAccessMethod);

Требования

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

См. также

IWDFDevice2

IWDFDeviceInitialize2::SetIoTypePreference

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