DXGKDDI_OPM_GET_CERTIFICATE fonction de rappel (dispmprt.h)

Article
04/03/2024

La fonction DxgkDdiOPMGetCertificate récupère un certificat du type et de la taille donnés.

Syntaxe

DXGKDDI_OPM_GET_CERTIFICATE DxgkddiOpmGetCertificate;

NTSTATUS DxgkddiOpmGetCertificate(
  [in]  PVOID MiniportDeviceContext,
  [in]  DXGKMDT_CERTIFICATE_TYPE CertificateType,
  [in]  ULONG CertificateSize,
  [out] PVOID CertificateBuffer
)
{...}

Paramètres

[in] MiniportDeviceContext

Handle d’un bloc de contexte associé à une carte d’affichage. Auparavant, la fonction DxgkDdiAddDevice du pilote miniport d’affichage fournissait cette poignée au sous-système du noyau graphique DirectX.

[in] CertificateType

Valeur de type DXGKMDT_CERTIFICATE_TYPE qui identifie le type de certificat à récupérer.

[in] CertificateSize

Taille, en octets, du certificat à récupérer. Cette taille a été retournée par un appel à la fonction DxgkDdiOPMGetCertificateSize du pilote miniport d’affichage.

[out] CertificateBuffer

Pointeur vers une mémoire tampon qui reçoit le certificat demandé si DxgkDdiOPMGetCertificate retourne correctement. Si DxgkDdiOPMGetCertificate échoue, le contenu de la mémoire tampon est inchangé.

Valeur retournée

DxgkDdiOPMGetCertificate retourne l’une des valeurs suivantes.

Code de retour	Description
STATUS_SUCCESS	La fonction a correctement récupéré la taille du certificat.
STATUS_GRAPHICS_OPM_NOT_SUPPORTED	Le pilote miniport d’affichage ne prend pas en charge OPM, soit parce que le fournisseur de matériel n’a jamais signé le contrat de licence OPM ou que le matériel graphique du pilote miniport ne respecte pas les règles OPM. DxgkDdiOPMGetCertificate peut également retourner cette valeur si le pilote de miniport d’affichage a détecté une falsification.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	Le pilote miniport d’affichage ne prend pas en charge COPP, soit parce que le fournisseur de matériel n’a jamais signé le contrat de licence COPP ou que le matériel graphique du pilote miniport ne respecte pas les règles COPP. DxgkDdiOPMGetCertificate peut également retourner cette valeur si le pilote de miniport d’affichage a détecté une falsification.
STATUS_GRAPHICS_UAB_NOT_SUPPORTED	Le pilote miniport d’affichage ne prend pas en charge UAB, soit parce que le fournisseur de matériel n’a jamais signé le contrat de licence UAB ou que le matériel graphique du pilote miniport ne respecte pas les règles UAB. DxgkDdiOPMGetCertificate peut également retourner cette valeur si le pilote de miniport d’affichage a détecté une falsification.
STATUS_GRAPHICS_PVP_HFS_FAILED	L’analyse des fonctionnalités matérielles du pilote miniport d’affichage (HFS) a échoué ou le pilote miniport d’affichage a détecté une falsification. Un pilote de miniport d’affichage peut éventuellement retourner cette valeur. Si DxgkDdiOPMGetCertificate ne retourne pas cette valeur pour falsification, il peut retourner l’un des codes d’erreur précédents à la place.

Cette fonction peut également retourner d’autres codes d’erreur définis dans Ntstatus.h.

Remarques

DxgkDdiOPMGetCertificate peut récupérer le certificat OPM du pilote miniport d’affichage, le certificat UAB (User Accessible Bus) ou le certificat COPP (Certified Output Protection Protocol). Pour plus d’informations sur ces certificats, téléchargez le document Protection du contenu de sortie et Windows Vista .

DxgkDdiOPMGetCertificate doit être mis en page.