EngProbeForReadAndWrite function (winddi.h)

The EngProbeForReadAndWrite function probes a structure for read and write accessibility.

Syntax

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

Parameters

[in, out] 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. This parameter is 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

EngProbeForReadAndWrite 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 both read- and write-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

EngProbeForRead