GetCertificate function

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 certificate for a display driver.

Syntax


NTSTATUS WINAPI GetCertificate(
  _In_  PUNICODE_STRING          pstrDeviceName,
  _In_  DXGKMDT_CERTIFICATE_TYPE ctPVPCertificateType,
  _Out_ BYTE                     *pbCertificate,
  _Out_ ULONG                    ulCertificateLength
);

Parameters

pstrDeviceName [in]

A pointer to a UNICODE_STRING structure that contains the name of the display device, as returned by the GetMonitorInfo function.

ctPVPCertificateType [in]

The type of certificate, specified as a member of the DXGKMDT_CERTIFICATE_TYPE enumeration.

pbCertificate [out]

A pointer to a buffer that receives the certificate.

ulCertificateLength [out]

The size of the pbCertificate buffer, in bytes. To get the size of the certificate, call GetCertificateSize.

Return value

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

Remarks

Applications should call the IOPMVideoOutput::StartInitialization method instead of this function.

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

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

 

 

Show: