функция READ_REGISTER_BUFFER_USHORT (wdm.h)

Статья
08/08/2023

Подпрограмма READ_REGISTER_BUFFER_USHORT разыменовывает предоставленный указатель, вставляет барьер памяти и считывает набор значений USHORT из указанного адреса регистра в буфер.

Синтаксис

void READ_REGISTER_BUFFER_USHORT(
  [in]  volatile USHORT *Register,
  [out] PUSHORT         Buffer,
  [in]  ULONG           Count
);

Параметры

[in] Register

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

[out] Buffer

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

[in] Count

Указывает количество значений USHORT, считываемых в буфер.

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

None

Remarks

Эта подпрограмма вставляет барьер памяти в код. Этот барьер гарантирует, что каждая операция, которая отображается в исходном коде перед вызовом этой подпрограммы, будет завершена перед любой операцией, которая появляется после вызова.

Дополнительные сведения о барьерах памяти см. в разделе KeMemoryBarrier.

Размер буфера должен быть достаточно большим, чтобы содержать по крайней мере указанное количество значений USHORT.

Вызывающие READ_REGISTER_BUFFER_USHORT могут выполняться в любой среде IRQL, при условии, что буфер является резидентным, а регистр — резидентной памятью устройства.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 2000.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включает Wdm.h, Ntddk.h, Ntifs.h, Miniport.h, Wudfwdm.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	Любой уровень (см. раздел "Примечания")