DXGKDDI_OPM_GET_CERTIFICATE_SIZE fonction de rappel (dispmprt.h)

Article
04/03/2024

La fonction DxgkDdiOPMGetCertificateSize récupère la taille d’un certificat du type donné.

Syntaxe

DXGKDDI_OPM_GET_CERTIFICATE_SIZE DxgkddiOpmGetCertificateSize;

NTSTATUS DxgkddiOpmGetCertificateSize(
  [in]  PVOID MiniportDeviceContext,
  [in]  DXGKMDT_CERTIFICATE_TYPE CertificateType,
  [out] PULONG CertificateSize
)
{...}

Paramètres

[in] MiniportDeviceContext

Handle vers un bloc de contexte associé à un adaptateur d’affichage. Auparavant, la fonction DxgkDdiAddDevice du pilote miniport d’affichage fournissait ce handle au sous-système du noyau graphique DirectX.

[in] CertificateType

Valeur de type DXGKMDT_CERTIFICATE_TYPE qui identifie le type de certificat dont la taille DxgkDdiOPMGetCertificateSize retourne.

[out] CertificateSize

Pointeur vers une variable qui reçoit la taille, en octets, du certificat dont le type est identifié par la valeur dans le paramètre CertificateType .

Valeur retournée

DxgkDdiOPMGetCertificateSize 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. DxgkDdiOPMGetCertificateSize peut également retourner cette valeur si le pilote de miniport d’affichage a détecté une falsification.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	Le pilote de 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. DxgkDdiOPMGetCertificateSize peut également retourner cette valeur si le pilote miniport a détecté une falsification.
STATUS_GRAPHICS_UAB_NOT_SUPPORTED	Le pilote de 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. DxgkDdiOPMGetCertificateSize 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 de miniport d’affichage (HFS) a échoué ou le pilote de miniport d’affichage a détecté une falsification. Un pilote de miniport d’affichage peut éventuellement retourner cette valeur. Si DxgkDdiOPMGetCertificateSize 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

DxgkDdiOPMGetCertificateSize peut récupérer la taille du certificat OPM du pilote miniport d’affichage, du certificat UAB (User Accessible Bus) ou du 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 .

DxgkDdiOPMGetCertificateSize doit être rendu paginable.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8
Serveur minimal pris en charge	Windows Server 2012
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL (voir la section Remarques)

Voir aussi

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDevice

Partager via