Edit

EngProbeForRead function (winddi.h)

  • Article

The EngProbeForRead function probes a structure for read accessibility.

Syntax

ENGAPI VOID EngProbeForRead(
  [in] PVOID Address,
  [in] ULONG Length,
  [in] ULONG Alignment
);

Parameters

[in] Address

Pointer to the structure to be probed.

[in] Length

Specifies the length, in bytes, of the structure to be probed.

[in] Alignment

Specifies the required alignment of the structure, expressed as the number of bytes in the base data type. For example, an alignment of 1 indicates that Address be aligned on a BYTE boundary, 2 specifies alignment on a WORD boundary, and 4 specifies alignment on a DWORD boundary.

Return value

None

Remarks

EngProbeForRead causes an exception to be raised if the structure pointed to by Address:

  • Does not have a base address that begins on an alignment-byte boundary.
  • Is not read-accessible.

Requirements

Requirement Value
Minimum supported client Available in Windows 2000 and later versions of the Windows operating systems.
Target Platform Universal
Header winddi.h (include Winddi.h)
Library Win32k.lib
DLL Win32k.sys

See also

EngProbeForReadAndWrite