DxgkDdiOPMGetCertificate routine

The DxgkDdiOPMGetCertificate function retrieves a certificate of the given type and size.

Syntax


DXGKDDI_OPM_GET_CERTIFICATE DxgkDdiOPMGetCertificate;

NTSTATUS DxgkDdiOPMGetCertificate(
  _In_   PVOID                    MiniportDeviceContext,
  _In_   DXGKMDT_CERTIFICATE_TYPE CertificateType,
  _In_   ULONG                    CertificateSize,
  _Out_  PVOID                    CertificateBuffer
)
{ ... }

Parameters

MiniportDeviceContext [in]

A handle to a context block associated with a display adapter. Previously, the display miniport driver's DxgkDdiAddDevice function provided this handle to the DirectX graphics kernel subsystem.

CertificateType [in]

A DXGKMDT_CERTIFICATE_TYPE-typed value that identifies the type of certificate to retrieve.

CertificateSize [in]

The size, in bytes, of the certificate to retrieve. This size was returned by a call to the display miniport driver's DxgkDdiOPMGetCertificateSize function.

CertificateBuffer [out]

A pointer to a buffer that receives the requested certificate if DxgkDdiOPMGetCertificate returns successfully. If DxgkDdiOPMGetCertificate fails, the contents of the buffer are unchanged.

Return value

DxgkDdiOPMGetCertificate returns one of the following values.

Return codeDescription
STATUS_SUCCESS

The function successfully retrieved the certificate.

STATUS_GRAPHICS_OPM_NOT_SUPPORTED

The display miniport driver does not support OPM either because the hardware vender never signed the OPM license agreement or the miniport driver's graphics hardware does not comply with OPM rules. DxgkDdiOPMGetCertificate can also return this value if the display miniport driver detected tampering.

STATUS_GRAPHICS_COPP_NOT_SUPPORTED

The display miniport driver does not support COPP either because the hardware vender never signed the COPP license agreement or the miniport driver's graphics hardware does not comply with COPP rules. DxgkDdiOPMGetCertificate can also return this value if the display miniport driver detected tampering.

STATUS_GRAPHICS_UAB_NOT_SUPPORTED

The display miniport driver does not support UAB either because the hardware vender never signed the UAB license agreement or the miniport driver's graphics hardware does not comply with UAB rules. DxgkDdiOPMGetCertificate can also return this value if the display miniport driver detected tampering.

STATUS_GRAPHICS_PVP_HFS_FAILED

The display miniport driver's hardware functionality scan (HFS) failed or the display miniport driver detected tampering. A display miniport driver can optionally return this value. If DxgkDdiOPMGetCertificate does not return this value for tampering, it can return one of the previous error codes instead.

 

This function might also return other error codes that are defined in Ntstatus.h.

Remarks

DxgkDdiOPMGetCertificate can retrieve the display miniport driver's OPM certificate, User Accessible Bus (UAB) certificate, or Certified Output Protection Protocol (COPP) certificate. For information about these certificates, download the Output Content Protection document from the Output Content Protection and Windows Vista website.

DxgkDdiOPMGetCertificate should be made pageable.

Requirements

Target platform

Desktop

Header

Dispmprt.h (include Dispmprt.h)

IRQL

PASSIVE_LEVEL (see Remarks section)

See also

DxgkDdiAddDevice
DxgkDdiOPMGetCertificateSize
DXGKMDT_CERTIFICATE_TYPE

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft