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 は、次のいずれかの値を返します。

リターン コード 説明
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) 証明書のサイズを取得できます。 これらの証明書の詳細については、 Output Content Protection と Windows Vista のドキュメントをダウンロードしてください。

DxgkDdiOPMGetCertificateSize をページング可能にする必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 8
サポートされている最小のサーバー Windows Server 2012
対象プラットフォーム デスクトップ
Header dispmprt.h (Dispmprt.h を含む)
IRQL PASSIVE_LEVEL (「解説」セクションを参照)

こちらもご覧ください

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDevice