DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT コールバック関数 (dispmprt.h)
DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT関数は、指定された保護された出力オブジェクトを構成します。
構文
DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT DxgkddiOpmConfigureProtectedOutput;
NTSTATUS DxgkddiOpmConfigureProtectedOutput(
[in] PVOID MiniportDeviceContext,
[in] HANDLE ProtectedOutputHandle,
[in] const DXGKMDT_OPM_CONFIGURE_PARAMETERS *Parameters,
[in] ULONG AdditionalParametersSize,
[in] const VOID *AdditionalParameters
)
{...}
パラメーター
[in] MiniportDeviceContext
ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーの DxgkDdiAddDevice 関数は、以前は DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。
[in] ProtectedOutputHandle
保護された出力オブジェクトへのハンドル。 DxgkDdiOPMCreateProtectedOutput 関数は、保護された出力オブジェクトを作成し、そのハンドルを オブジェクトに返します。
[in] Parameters
ProtectedOutputHandleパラメーターでハンドルが指定されている保護された出力オブジェクトを構成するために使用されるパラメーターを含むDXGKMDT_OPM_CONFIGURE_PARAMETERS構造体へのポインター。
[in] AdditionalParametersSize
AdditionalParameters が指すバッファー内の追加パラメーターのサイズ (バイト単位)。 認定出力保護プロトコル (COPP) エミュレーションの場合、これは 0 です。
[in] AdditionalParameters
ProtectedOutputHandle パラメーターでハンドルが指定されている保護された出力オブジェクトの構成に使用される追加パラメーターを保持するバッファーへのポインター。 COPP エミュレーションの場合、これは NULL です。 AdditionalParametersSize パラメーターが 0 に設定されている場合、AdditionalParameters は常に NULL に設定されます。
戻り値
DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT は、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
| STATUS_SUCCESS | この関数は、保護された出力オブジェクトを正常に構成しました。 |
| STATUS_NO_MEMORY | DxgkDdiOPMConfigureProtectedOutput では、完了するために必要なメモリを割り当てることができません。 |
この関数は、 Ntstatus.h で定義されている他のエラー コードも返す場合があります。
注釈
DirectX グラフィックス カーネル サブシステムは 、DxgkDdiOPMGetInformation または DxgkDdiOPMGetCOPPCompatibleInformation を呼び出して出力に関する情報を取得し、 DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT を 1 回以上呼び出して出力を構成します。
DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT ページング可能にする必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | dispmprt.h (Dispmprt.h を含む) |
| IRQL | PASSIVE_LEVEL (「解説」セクションを参照) |
こちらもご覧ください
DxgkDdiOPMGetCOPPCompatibleInformation
DxgkDdiOPMCreateProtectedOutput