Функция WdfDeviceGetHardwareRegisterMappedAddress (wdfdevice.h)

  • Статья

[Относится только к UMDF]

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

Синтаксис

PVOID WdfDeviceGetHardwareRegisterMappedAddress(
  [in] WDFDEVICE Device,
  [in] PVOID     PseudoBaseAddress
);

Параметры

[in] Device

Дескриптор объекта устройства платформы.

[in] PseudoBaseAddress

Адрес расположения, которое получает указатель на псевдобазовой адрес.

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

Базовый адрес ресурсов в пользовательском режиме, сопоставленных ранее с помощью WdfDeviceMapIoSpace.

Комментарии

Эта функция является эквивалентом UMDF версии 2 IWDFDevice3::GetHardwareRegisterMappedAddress.

После вызова WdfDeviceGetHardwareRegisterMappedAddress драйвер может получить доступ к адресу в пользовательском режиме напрямую для чтения и записи в регистр.

Примечание Это не рекомендуемый подход для доступа к регистрам, так как он не позволяет UMDF выполнять какие-либо проверки доступа.
 

Если вы используете WdfDeviceGetHardwareRegisterMappedAddress, необходимо задать для директивы INF UmdfRegisterAccessMode значение RegisterAccessUsingUserModeMapping. Дополнительные сведения о директивах INF UMDF см. в разделе Указание директив WDF в INF-файлах.

Требования

Требование Значение
Минимальная версия клиента Windows 8.1
Целевая платформа Универсальное
Минимальная версия UMDF 2,0
Верхняя часть wdfdevice.h (включая Wdf.h)
Библиотека WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

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

IWDFDevice3::GetHardwareRegisterMappedAddress

WdfDeviceMapIoSpace