DXGKDDI_OPM_GET_CERTIFICATE回呼函式 （dispmprt.h）
DxgkDdiOPMGetCertificate 函式會擷取指定類型和大小的憑證。
語法
DXGKDDI_OPM_GET_CERTIFICATE DxgkddiOpmGetCertificate;
NTSTATUS DxgkddiOpmGetCertificate(
[in] PVOID MiniportDeviceContext,
[in] DXGKMDT_CERTIFICATE_TYPE CertificateType,
[in] ULONG CertificateSize,
[out] PVOID CertificateBuffer
)
{...}
參數
[in] MiniportDeviceContext
與顯示配接器相關聯的內容區塊句柄。 先前，顯示迷你埠驅動程式的 DxgkDdiAddDevice 函式會提供此句柄給 DirectX 圖形核心子系統。
[in] CertificateType
識別要擷取之憑證類型的 DXGKMDT_CERTIFICATE_TYPE型別值。
[in] CertificateSize
要擷取之憑證的大小，以位元組為單位。 這個大小是由呼叫顯示迷你埠驅動程式的 DxgkDdiOPMGetCertificateSize 函式所傳回。
[out] CertificateBuffer
如果 DxgkDdiOPMGetCertificate 傳回成功，則為接收要求憑證之緩衝區的指標。 如果 DxgkDdiOPMGetCertificate 失敗，則緩衝區的內容不會變更。
傳回值
DxgkDdiOPMGetCertificate 會傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
| STATUS_SUCCESS | 函式已成功擷取憑證大小。 |
| STATUS_GRAPHICS_OPM_NOT_SUPPORTED | 顯示迷你埠驅動程式不支援 OPM，因為硬體廠商從未簽署 OPM 許可協定，或迷你埠驅動程式的圖形硬體不符合 OPM 規則。 如果顯示迷你埠驅動程序偵測到竄改，DxgkDdiOPMGetCertificate 也可以傳回此值。 |
| STATUS_GRAPHICS_COPP_NOT_SUPPORTED | 顯示迷你埠驅動程式不支援 COPP，因為硬體廠商從未簽署 COPP 許可協定，或迷你埠驅動程式的圖形硬體不符合 COPP 規則。 如果顯示迷你埠驅動程序偵測到竄改，DxgkDdiOPMGetCertificate 也可以傳回此值。 |
| STATUS_GRAPHICS_UAB_NOT_SUPPORTED | 顯示迷你埠驅動程式不支援 UAB，因為硬體廠商從未簽署 UAB 許可協定，或迷你埠驅動程式的圖形硬體不符合 UAB 規則。 如果顯示迷你埠驅動程序偵測到竄改，DxgkDdiOPMGetCertificate 也可以傳回此值。 |
| STATUS_GRAPHICS_PVP_HFS_FAILED | 顯示迷你埠驅動程序的硬體功能掃描 （HFS） 失敗，或顯示迷你埠驅動程序偵測到竄改。 顯示迷你埠驅動程式可以選擇性地傳回此值。 如果 DxgkDdiOPMGetCertificate 未傳回此值進行竄改，它可以改為傳回先前的其中一個錯誤碼。 |
此函式也可能傳回 Ntstatus.h中定義的其他錯誤碼。
言論
DxgkDdiOPMGetCertificate 可以擷取顯示迷你埠驅動程式的 OPM 憑證、用戶可存取總線 （UAB） 憑證或認證輸出保護通訊協定 （COPP） 憑證。 如需這些憑證的相關信息，請下載 輸出內容保護和 Windows Vista 檔。
DxgkDdiOPMGetCertificate 應設為可分頁。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 桌面 |
| 標頭 | dispmprt.h （包括 Dispmprt.h） |
| IRQL | PASSIVE_LEVEL （請參閱一節） |