DXGKDDI_OPM_GET_CERTIFICATE_SIZE回呼函式 (dispmprt.h)

  • 發行項

DxgkDdiOPMGetCertificateSize 函式會擷取指定類型的憑證大小。

語法

DXGKDDI_OPM_GET_CERTIFICATE_SIZE DxgkddiOpmGetCertificateSize;

NTSTATUS DxgkddiOpmGetCertificateSize(
  [in]  PVOID MiniportDeviceContext,
  [in]  DXGKMDT_CERTIFICATE_TYPE CertificateType,
  [out] PULONG CertificateSize
)
{...}

參數

[in] MiniportDeviceContext

與顯示配接器相關聯的內容區塊句柄。 先前，顯示迷你埠驅動程式的 DxgkDdiAddDevice 函式會提供此句柄給 DirectX 圖形核心子系統。

[in] CertificateType

識別大小為 DxgkDdiOPMGetCertificateSize 之憑證類型的DXGKMDT_CERTIFICATE_TYPE型別值。

[out] CertificateSize

變數的指標，可接收憑證的大小，以位元組為單位，其類型是由 CertificateType 參數中的值所識別。

傳回值

DxgkDdiOPMGetCertificateSize 會傳回下列其中一個值：

傳回碼 Description
STATUS_SUCCESS 函式已成功擷取憑證大小。
STATUS_GRAPHICS_OPM_NOT_SUPPORTED 顯示迷你埠驅動程式不支援 OPM，因為硬體廠商從未簽署 OPM 許可協定，或迷你埠驅動程式的圖形硬體不符合 OPM 規則。 如果顯示迷你埠驅動程序偵測到竄改，DxgkDdiOPMGetCertificateSize 也可以傳回此值。
STATUS_GRAPHICS_COPP_NOT_SUPPORTED 顯示迷你埠驅動程式不支援 COPP，因為硬體廠商從未簽署 COPP 許可協定，或迷你埠驅動程式的圖形硬體不符合 COPP 規則。 如果迷你埠驅動程序偵測到竄改，DxgkDdiOPMGetCertificateSize 也可以傳回此值。
STATUS_GRAPHICS_UAB_NOT_SUPPORTED 顯示迷你埠驅動程式不支援 UAB，因為硬體廠商從未簽署 UAB 許可協定，或迷你埠驅動程式的圖形硬體不符合 UAB 規則。 如果顯示迷你埠驅動程序偵測到竄改，DxgkDdiOPMGetCertificateSize 也可以傳回此值。
STATUS_GRAPHICS_PVP_HFS_FAILED 顯示迷你埠驅動程序的硬體功能掃描 (HFS) 失敗，或顯示迷你埠驅動程序偵測到竄改。 顯示迷你埠驅動程式可以選擇性地傳回此值。 如果 DxgkDdiOPMGetCertificateSize 未傳回此值以進行竄改，它可以改為傳回上述其中一個錯誤碼。

此函式也可能傳回 Ntstatus.h 中定義的其他錯誤碼。

備註

DxgkDdiOPMGetCertificateSize 可以擷取顯示迷你埠驅動程式 OPM 憑證的大小、使用者存取總線 (UAB) 憑證，或認證輸出保護通訊協定 (COPP) 憑證的大小。 如需這些憑證的相關信息，請下載 輸出內容保護和 Windows Vista 檔。

DxgkDdiOPMGetCertificateSize 應該設為可分頁。

規格需求

需求 值
最低支援的用戶端 Windows 8
最低支援的伺服器 Windows Server 2012
目標平台 桌面
標頭 dispmprt.h (包括 Dispmprt.h)
IRQL PASSIVE_LEVEL (请参阅一节)

另請參閱

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDevice