DXGKDDI_OPM_GET_CERTIFICATE_SIZE fonction de rappel (dispmprt.h)

Article
02/06/2025

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 d’affichage du pilote miniport DxgkDdiAddDevice fournissait ce handle au sous-système du noyau graphique DirectX.

[in] CertificateType

Valeur DXGKMDT_CERTIFICATE_TYPE-typée 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 de retour

DxgkDdiOPMGetCertificateSize retourne l’une des valeurs suivantes :

Retourner le code	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, car le fournisseur de matériel n’a jamais signé le contrat de licence OPM ou le matériel graphique du pilote miniport ne respecte pas les règles OPM. DxgkDdiOPMGetCertificateSize peut également retourner cette valeur si le pilote miniport d’affichage a détecté une falsification.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	Le pilote miniport d’affichage ne prend pas en charge COPP, car le fournisseur de matériel n’a jamais signé le contrat de licence COPP ou 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 miniport d’affichage ne prend pas en charge UAB, car le fournisseur de matériel n’a jamais signé le contrat de licence UAB ou le matériel graphique du pilote miniport ne respecte pas les règles UAB. DxgkDdiOPMGetCertificateSize peut également retourner cette valeur si le pilote miniport d’affichage a détecté une falsification.
STATUS_GRAPHICS_PVP_HFS_FAILED	Échec de l’analyse de la fonctionnalité matérielle du pilote miniport d’affichage (HFS) ou du pilote de miniport d’affichage détecté une falsification. Un pilote miniport d’affichage peut éventuellement renvoyer cette valeur. Si DxgkDdiOPMGetCertificateSize ne retourne pas cette valeur pour falsification, elle 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 pouvez récupérer la taille du 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 Output Content Protection et Windows Vista.

DxgkDdiOPMGetCertificateSize doit être rendu paginable.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 8
serveur minimum pris en charge	Windows Server 2012
plateforme cible	Bureau
d’en-tête	dispmprt.h (include Dispmprt.h)
IRQL	PASSIVE_LEVEL (voir la section Remarques)

Voir aussi

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDevice

Partager via