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 (「解説」セクションを参照) |