GetOPMRandomNumber function

  • Article

Important

This function is used by Output Protection Manager (OPM) to access functionality in the display driver. Applications should not call this function.

 

Gets a 128-bit, cryptographically secure random number from a protected output object.

Syntax

NTSTATUS WINAPI GetOPMRandomNumber(
  _In_  OPM_PROTECTED_OUTPUT_HANDLE opoOPMProtectedOutput,
  _Out_ DXGKMDT_OPM_RANDOM_NUMBER   *prnRandomNumber
);

Parameters

opoOPMProtectedOutput [in]

A handle to the protected output object. This handle is obtained by calling CreateOPMProtectedOutputs.

prnRandomNumber [out]

A pointer to a DXGKMDT_OPM_RANDOM_NUMBER structure that receives the random number.

Return value

If the method succeeds, it returns STATUS_SUCCESS. Otherwise, it returns an NTSTATUS error code.

Remarks

This function has no associated import library. To call this function, you must use the LoadLibrary and GetProcAddress functions to dynamically link to Gdi32.dll.

Requirements

Requirement Value
Minimum supported client
 Windows Vista [desktop apps only]
Minimum supported server
 Windows Server 2008 [desktop apps only]
DLL
Gdi32.dll

See also

OPM Functions

Output Protection Manager