PsRequestGetMaxReadMmioVirtualBufferSize

Returns the maximum size of the buffer that may be used with the PsRequestReadMmioVirtual function.

Syntax

uint64_t PsRequestGetMaxReadMmioVirtualBufferSize(
 [in] PPS_REQUEST pRequest
);

Parameters

PPS_REQUEST pRequest

An opaque handle to a request created by the PsRequestCreate function.

Return value

If the function succeeds, it returns a non-zero value for the size of the buffer in bytes.

If it fails, it returns 0 (zero) due to one of the following possible reasons:

  • The pRequest parameter is NULL.
  • There is no assigned transport for the engine used for this request.

    • Remarks

    The maximum buffer size is subject to change depending on the debug protocol version.

    The effective buffer size may be smaller depending on the MMIO access size. For example, if the access size is 4 and the maximum size is 0x123, the effective maximum size would be 0x120 because the buffer should be aligned for 4-byte access.