Функция 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, необходимо задать директиву UmdfRegisterAccessMode INF RegisterAccessUsingUsingUserModeMapping. Дополнительные сведения о директивах INF UMDF см. в разделе Указание директив WDF в INF-файлах.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 8.1
целевая платформа Всеобщий
минимальная версия UMDF 2.0
заголовка wdfdevice.h (include Wdf.h)
библиотеки WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

См. также

IWDFDevice3::GetHardwareRegisterMappedAddress

WdfDeviceMapIoSpace