次の方法で共有

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

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

必要条件

要件 価値
ターゲット プラットフォーム の デスクトップ
ヘッダー dispmprt.h (Dispmprt.h を含む)
IRQL PASSIVE_LEVEL (「解説」セクションを参照)

関連項目

DXGKMDT_CERTIFICATE_TYPE

DxgkDdiAddDeviceの

DxgkDdiOPMGetCertificateSize