DXGKDDI_OPM_GET_CERTIFICATE_SIZE Rückruffunktion (dispmprt.h)
Die DxgkDdiOPMGetCertificateSize-Funktion ruft die Größe eines Zertifikats des angegebenen Typs ab.
Syntax
DXGKDDI_OPM_GET_CERTIFICATE_SIZE DxgkddiOpmGetCertificateSize;
NTSTATUS DxgkddiOpmGetCertificateSize(
[in] PVOID MiniportDeviceContext,
[in] DXGKMDT_CERTIFICATE_TYPE CertificateType,
[out] PULONG CertificateSize
)
{...}
Parameter
[in] MiniportDeviceContext
Ein Handle für einen Kontextblock, der einem Anzeigeadapter 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 Zertifikattyp identifiziert, dessen Größe DxgkDdiOPMGetCertificateSize zurückgibt.
[out] CertificateSize
Ein Zeiger auf eine Variable, die die Größe des Zertifikats in Bytes empfängt, dessen Typ durch den Wert im CertificateType-Parameter identifiziert wird.
Rückgabewert
DxgkDdiOPMGetCertificateSize 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. DxgkDdiOPMGetCertificateSize 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. DxgkDdiOPMGetCertificateSize kann diesen Wert auch zurückgeben, wenn der Miniporttreiber 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. DxgkDdiOPMGetCertificateSize 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 DxgkDdiOPMGetCertificateSize 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
DxgkDdiOPMGetCertificateSize kann die Größe des OPM-Zertifikats des Anzeigeminiporttreibers, des UAB-Zertifikats (User Accessible Bus) oder des COPP-Zertifikats (Certified Output Protection Protocol) abrufen. Laden Sie das Dokument Ausgabeinhaltsschutz und Windows Vista herunter, um Informationen zu diesen Zertifikaten zu erfahren.
DxgkDdiOPMGetCertificateSize sollte ausgelagert werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Unterstützte Mindestversion (Server) | Windows Server 2012 |
| Zielplattform | Desktop |
| Kopfzeile | dispmprt.h (include Dispmprt.h) |
| IRQL | PASSIVE_LEVEL (siehe Abschnitt Hinweise) |