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

[Предупреждение: 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 типизированное значение. Это значение, определяющее метод доступа к буферу, который платформа использует для запросов управления вводом-выводом устройства.

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

None

Remarks

Если драйвер вызывает 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 (включая Wudfddi.h)
DLL	WUDFx.dll

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

IWDFDevice2

IWDFDeviceInitialize2::SetIoTypePreference