Метод 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 |