PRM_INVOKE_HANDLER callback function (prminterface.h)

This routine invokes a specific PRM handler.

Syntax

PRM_INVOKE_HANDLER PrmInvokeHandler;

NTSTATUS PrmInvokeHandler(
  [in]  LPGUID HandlerGuid,
  [in]  PVOID ParameterBuffer,
  [in]  ULONG Reserved,
  [out] PULONG64 EfiStatus
)
{...}

Parameters

[in] HandlerGuid

Pointer to a 128-bit unique identifier that specifies the PRM handler to invoke.

[in] ParameterBuffer

Pointer to a caller-allocated PRM handler parameter buffer.

[in] Reserved

Reserved. Set to zero.

[out] EfiStatus

Pointer to a ULONG64 which, on output, contains the EFI status from the PRM handler invocation.

Return value

This method returns NTSTATUS which contains STATUS_SUCCESS if the call was successful. Otherwise, the method returns an appropriate error code.

Remarks

PRM_INVOKE_HANDLER is not a system routine that can be called directly by name. This routine is callable only by pointer from the address returned in a PRM_INTERFACE structure. Drivers obtain the address of this routine by calling ExGetPrmInterface.

Requirements

Requirement Value
Minimum supported client Windows 11, version 24H2
Header prminterface.h
IRQL <= HIGH_LEVEL

See also

Windows Kernel-Mode PRM Library