DXGKDDI_OPM_CONFIGURE_PROTECTED_OUTPUT コールバック関数 (dispmprt.h)

[アーティクル]
08/07/2023

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