IDirect3DAuthenticatedChannel9::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 IDirect3DAuthenticatedChannel9::GetCertificateSize.

ppCertificate

A pointer to a byte array that receives the driver's X.509 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

You can use the certificate chain to verify that the driver's certificate was signed by Microsoft and has not been revoked. The driver's certificate also contains the driver's public key. Use the public key to establish a session key, by calling the IDirect3DAuthenticatedChannel9::NegotiateKeyExchange method.

This method fails if the channel type is D3DAUTHENTICATEDCHANNEL_D3D9, because the Direct3D 9 channel does not support authentication.

Requirements

See also

GPU-Based Content Protection

IDirect3DAuthenticatedChannel9