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