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 會傳回下列其中一個值。
| 傳回碼 | Description |
|---|---|
| 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 (请参阅一节) |