IDirect3DCryptoSession9::GetCertificate method
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 exhange, the driver might use some other type of certificate, or might not provide a certificate.
Requirements
|
Minimum supported client |
Windows 7 [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 R2 [desktop apps only] |
|
Header |
|
See also