READ_REGISTER_BUFFER_ULONG function (wdm.h)
The READ_REGISTER_BUFFER_ULONG routine dereferences the supplied pointer, inserts a memory barrier, and reads a set of ULONG values from the specified register address into a buffer.
Syntax
void READ_REGISTER_BUFFER_ULONG(
[in] volatile ULONG *Register,
[out] PULONG Buffer,
[in] ULONG Count
);
Parameters
[in] Register
Pointer to the register, which must be a mapped range in memory space.
[out] Buffer
Pointer to a buffer into which an array of ULONG values is read.
[in] Count
Specifies the number of ULONG values to be read into the buffer.
Return value
None
Remarks
This routine inserts a memory barrier into your code. This barrier guarantees that every operation that appears in the source code before the call to this routine will complete before any operation that appears after the call.
For more info about memory barriers, see KeMemoryBarrier.
The size of the buffer must be large enough to contain at least the specified number of ULONG values.
Callers of READ_REGISTER_BUFFER_ULONG can be running at any IRQL, assuming the Buffer is resident and the Register is resident, mapped device memory.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Available starting with Windows 2000. |
Target Platform | Universal |
Header | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h, Miniport.h, Wudfwdm.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | Any level (see Remarks section) |