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 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 Typ des Zertifikats identifiziert, dessen Größe DxgkDdiOPMGetCertificateSize zurückgegeben wird.
[out] CertificateSize
Ein Zeiger auf eine Variable, die die Größe des Zertifikats in Byte 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-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. DxgkDdiOPMGetCertificateSize kann diesen Wert auch zurückgeben, wenn der Anzeige-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. DxgkDdiOPMGetCertificateSize kann diesen Wert auch zurückgeben, wenn der Miniporttreiber Manipulation erkannt 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. DxgkDdiOPMGetCertificateSize kann diesen Wert auch zurückgeben, wenn der Anzeige-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 DxgkDdiOPMGetCertificateSize 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
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. Um Informationen zu diesen Zertifikaten zu finden, laden Sie das Dokument Ausgabeinhaltsschutz und Windows Vista herunter.
DxgkDdiOPMGetCertificateSize sollte seitenfähig gemacht werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| mindestens unterstützte Server- | Windows Server 2012 |
| Zielplattform- | Desktop |
| Header- | dispmprt.h (include Dispmprt.h) |
| IRQL- | PASSIVE_LEVEL (siehe Abschnitt "Hinweise") |