DXGKDDI_OPM_GET_CERTIFICATE fungsi panggilan balik (dispmprt.h)

Artikel
04/03/2024

Fungsi DxgkDdiOPMGetCertificate mengambil sertifikat dari jenis dan ukuran yang diberikan.

Sintaks

DXGKDDI_OPM_GET_CERTIFICATE DxgkddiOpmGetCertificate;

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

Parameter

[in] MiniportDeviceContext

Handel ke blok konteks yang terkait dengan adaptor tampilan. Sebelumnya, fungsi DxgkDdiAddDevice driver miniport tampilan memberikan handel ini ke subsistem kernel grafis DirectX.

[in] CertificateType

Nilai jenis DXGKMDT_CERTIFICATE_TYPE yang mengidentifikasi jenis sertifikat yang akan diambil.

[in] CertificateSize

Ukuran, dalam byte, dari sertifikat yang akan diambil. Ukuran ini dikembalikan oleh panggilan ke fungsi DxgkDdiOPMGetCertificateSize driver miniport tampilan.

[out] CertificateBuffer

Penunjuk ke buffer yang menerima sertifikat yang diminta jika DxgkDdiOPMGetCertificate berhasil dikembalikan. Jika DxgkDdiOPMGetCertificate gagal, konten buffer tidak berubah.

Menampilkan nilai

DxgkDdiOPMGetCertificate mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Fungsi berhasil mengambil ukuran sertifikat.
STATUS_GRAPHICS_OPM_NOT_SUPPORTED	Driver miniport tampilan tidak mendukung OPM baik karena vendor perangkat keras tidak pernah menandatangani perjanjian LISENSI OPM atau perangkat keras grafis driver miniport tidak mematuhi aturan OPM. DxgkDdiOPMGetCertificate juga dapat mengembalikan nilai ini jika driver miniport tampilan terdeteksi perubahan.
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	Driver miniport tampilan tidak mendukung COPP karena vendor perangkat keras tidak pernah menandatangani perjanjian lisensi COPP atau perangkat keras grafis driver miniport tidak mematuhi aturan COPP. DxgkDdiOPMGetCertificate juga dapat mengembalikan nilai ini jika driver miniport tampilan terdeteksi perubahan.
STATUS_GRAPHICS_UAB_NOT_SUPPORTED	Driver miniport tampilan tidak mendukung UAB baik karena vendor perangkat keras tidak pernah menandatangani perjanjian LISENSI UAB atau perangkat keras grafis driver miniport tidak mematuhi aturan UAB. DxgkDdiOPMGetCertificate juga dapat mengembalikan nilai ini jika driver miniport tampilan terdeteksi perubahan.
STATUS_GRAPHICS_PVP_HFS_FAILED	Pemindaian fungsionalitas perangkat keras (HFS) driver miniport tampilan gagal atau driver miniport tampilan terdeteksi merusak. Driver miniport tampilan dapat secara opsional mengembalikan nilai ini. Jika DxgkDdiOPMGetCertificate tidak mengembalikan nilai ini untuk mengubah, DxgkDdiOPMGetCertificate dapat mengembalikan salah satu kode kesalahan sebelumnya sebagai gantinya.

Fungsi ini mungkin juga mengembalikan kode kesalahan lain yang ditentukan dalam Ntstatus.h.

Keterangan

DxgkDdiOPMGetCertificate dapat mengambil sertifikat OPM driver miniport tampilan, sertifikat User Accessible Bus (UAB), atau sertifikat Certified Output Protection Protocol (COPP). Untuk informasi tentang sertifikat ini, unduh dokumen Perlindungan Konten Output dan Windows Vista .

DxgkDdiOPMGetCertificate harus dibuat dapat dipaginasi.