DXGKDDI_OPM_GET_CERTIFICATE Rückruffunktion (dispmprt.h)

Artikel
02/06/2025

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 zu einem Kontextblock, der einem Anzeigeadapter zugeordnet ist. Zuvor stellte die DxgkDdiAddDevice-Funktion des Display-Miniporttreibers dieses Handle für das DirectX-Grafik-Kernel-Subsystem bereit.

[in] CertificateType

Ein DXGKMDT_CERTIFICATE_TYPE-typed-Wert, der den abzurufenden Zertifikattyp identifiziert.

[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, bleiben die Inhalte 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-Miniport-Treiber unterstützt OPM nicht, da der Hardwareanbieter nie den OPM-Lizenzvertrag unterzeichnet hat oder die Grafikhardware des Miniporttreibers nicht den OPM-Regeln entspricht. DxgkDdiOPMGetCertificate kann diesen Wert auch zurückgeben, wenn der Miniporttreiber Manipulationen festgestellt hat.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	Der Miniporttreiber unterstützt copp nicht, da der Hardwareanbieter nie den COPP-Lizenzvertrag unterzeichnet hat oder die Grafikhardware des Miniporttreibers nicht den COPP-Regeln entspricht. DxgkDdiOPMGetCertificate kann diesen Wert auch zurückgeben, wenn der Miniporttreiber Manipulationen festgestellt hat.
STATUS_GRAPHICS_UAB_NOT_SUPPORTED	Der Display-Miniporttreiber unterstützt UAB nicht, da der Hardwareanbieter nie den UAB-Lizenzvertrag unterzeichnet hat oder die Grafikhardware des Miniporttreibers nicht den UAB-Regeln entspricht. DxgkDdiOPMGetCertificate kann diesen Wert auch zurückgeben, wenn der Miniporttreiber Manipulationen festgestellt hat.
STATUS_GRAPHICS_PVP_HFS_FAILED	Fehler beim Hardware-Funktionsscan (HFS) des Anzeige-Miniporttreibers oder beim Miniporttreiber festgestellte Manipulationen. Ein Anzeigeminiporttreiber kann optional diesen Wert zurückgeben. Wenn DxgkDdiOPMGetCertificate diesen Wert nicht für Manipulationen zurückgibt, kann er stattdessen einen der vorherigen Fehlercodes zurückgeben.

Diese Funktion gibt möglicherweise auch andere Fehlercodes zurück, die in Ntstatus.hdefiniert sind.

Bemerkungen

DxgkDdiOPMGetCertificate kann das OPM-Zertifikat des Anzeigeminiporttreibers, das Zertifikat für den Benutzerzugriffsbus (User Accessible Bus, UAB) oder das COPP-Zertifikat (Certified Output Protection Protocol) abrufen. Um Informationen zu diesen Zertifikaten zu finden, laden Sie das Dokument Ausgabeinhaltsschutz und Windows Vista herunter.

DxgkDdiOPMGetCertificate sollte seitenfähig gemacht werden.