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

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

要件

要件	値
対象プラットフォーム	デスクトップ
Header	dispmprt.h (Dispmprt.h を含む)
IRQL	PASSIVE_LEVEL (「解説」セクションを参照)

こちらもご覧ください

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDevice

DxgkDdiOPMGetCertificateSize