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

DXGKMDT_CERTIFICATE_TYPE型別值，識別 DxgkDdiOPMGetCertificateSize 傳回之憑證的類型。

[out] CertificateSize

變數的指標，這個變數會接收憑證的大小，以位元組為單位，而該憑證的類型是由 certificateType 參數中的值所識別。

傳回值

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

傳回碼	描述
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