DXGKDDI_OPM_GET_CERTIFICATE Rückruffunktion (dispmprt.h)

Artikel
04/03/2024

Die DxgkDdiOPMGetCertificate-Funktion ruft ein Zertifikat des angegebenen Typs und der angegebenen Größe ab.

Syntax

DXGKDDI_OPM_GET_CERTIFICATE DxgkddiOpmGetCertificate;

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

Parameter

[in] MiniportDeviceContext

Ein Handle für einen Kontextblock, der einem Grafikkarte zugeordnet ist. Zuvor hat die DxgkDdiAddDevice-Funktion des Anzeigeminiporttreibers dieses Handle für das DirectX-Grafikkernsubsystem bereitgestellt.

[in] CertificateType

Ein DXGKMDT_CERTIFICATE_TYPE typisierter Wert, der den Typ des abzurufenden Zertifikats angibt.

[in] CertificateSize

Die Größe des abzurufenden Zertifikats in Bytes. Diese Größe wurde durch einen Aufruf der DxgkDdiOPMGetCertificateSize-Funktion des Anzeigeminiporttreibers zurückgegeben.

[out] CertificateBuffer

Ein Zeiger auf einen Puffer, der das angeforderte Zertifikat empfängt, wenn DxgkDdiOPMGetCertificate erfolgreich zurückgibt. Wenn dxgkDdiOPMGetCertificate fehlschlägt, bleibt der Inhalt des Puffers unverändert.

Rückgabewert

DxgkDdiOPMGetCertificate gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Funktion hat die Zertifikatgröße erfolgreich abgerufen.
STATUS_GRAPHICS_OPM_NOT_SUPPORTED	Der Display-Miniporttreiber unterstützt OPM nicht, da der Hardwarehersteller die OPM-Lizenzvereinbarung nie unterzeichnet hat oder die Grafikhardware des Miniporttreibers nicht den OPM-Regeln entspricht. DxgkDdiOPMGetCertificate kann diesen Wert auch zurückgeben, wenn der Anzeigeminiporttreiber Manipulationen erkannt hat.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	Der Display-Miniporttreiber unterstützt COPP nicht, da der Hardwarehersteller die COPP-Lizenzvereinbarung nie unterzeichnet hat oder die Grafikhardware des Miniporttreibers nicht den COPP-Regeln entspricht. DxgkDdiOPMGetCertificate kann diesen Wert auch zurückgeben, wenn der Anzeigeminiporttreiber Manipulationen erkannt hat.
STATUS_GRAPHICS_UAB_NOT_SUPPORTED	Der Display-Miniporttreiber unterstützt UAB nicht, da der Hardwarehersteller die UAB-Lizenzvereinbarung nie unterzeichnet hat oder die Grafikhardware des Miniporttreibers nicht den UAB-Regeln entspricht. DxgkDdiOPMGetCertificate kann diesen Wert auch zurückgeben, wenn der Anzeigeminiporttreiber Manipulationen erkannt hat.
STATUS_GRAPHICS_PVP_HFS_FAILED	Der Hardwarefunktionalitätsscan (HFS) des Anzeigeminiporttreibers ist fehlgeschlagen, oder der Anzeigeminiporttreiber hat Manipulationen erkannt. Ein Display-Miniporttreiber kann diesen Wert optional zurückgeben. Wenn DxgkDdiOPMGetCertificate diesen Wert nicht zur Manipulation zurückgibt, kann es stattdessen einen der vorherigen Fehlercodes zurückgeben.

Diese Funktion kann auch andere Fehlercodes zurückgeben, die in Ntstatus.h definiert sind.

Hinweise

DxgkDdiOPMGetCertificate kann das OPM-Zertifikat des Anzeigeminiporttreibers, das UAB-Zertifikat (User Accessible Bus) oder das COPP-Zertifikat (Certified Output Protection Protocol) abrufen. Laden Sie das Dokument Ausgabeinhaltsschutz und Windows Vista herunter, um Informationen zu diesen Zertifikaten zu erfahren.

DxgkDdiOPMGetCertificate sollte seitenfähig gemacht werden.