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 |