IDirect3DCryptoSession9::GetCertificate method (d3d9.h)

Gets the driver's certificate chain.

Syntax

HRESULT GetCertificate(
  UINT CertifacteSize,
  BYTE *ppCertificate
);

Parameters

CertifacteSize

The size of the ppCertificate array, in bytes. To get the size of the certificate chain, call IDirect3DCryptoSession9::GetCertificateSize.

ppCertificate

A pointer to a byte array that receives the driver's certificate chain. The caller must allocate the array.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The standard key-exchange mechanism uses the driver's Output Protection Manager (OPM) certificate, which is an X.509 certificate. The type of key exchange is given in the capabilities information returned by the IDirect3DDevice9Video::GetContentProtectionCaps method. The key-exchange mechanism is specified by the KeyExchangeType member of the D3DCONTENTPROTECTIONCAPS structure. If the value is D3DKEYEXCHANGE_RSAES_OAEP, an X.509 certificate is used.

For other types of key exchange, the driver might use some other type of certificate, or might not provide a certificate.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header d3d9.h

See also

GPU-Based Content Protection

IDirect3DCryptoSession9