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

[アーティクル]
04/03/2024

DxgkDdiOPMCreateProtectedOutput 関数は、Certified Output Protection Protocol (COPP) または OPM セマンティクスを使用して、新しい保護された出力オブジェクトを作成します。

構文

DXGKDDI_OPM_CREATE_PROTECTED_OUTPUT DxgkddiOpmCreateProtectedOutput;

NTSTATUS DxgkddiOpmCreateProtectedOutput(
  [in]  PVOID MiniportDeviceContext,
  [in]  D3DDDI_VIDEO_PRESENT_TARGET_ID VidPnTargetId,
  [in]  DXGKMDT_OPM_VIDEO_OUTPUT_SEMANTICS NewVideoOutputSemantics,
  [out] PHANDLE NewProtectedOutputHandle
)
{...}

パラメーター

[in] MiniportDeviceContext

ディスプレイアダプターに関連付けられているコンテキストブロックへのハンドル。以前は、ディスプレイミニポートドライバーの DxgkDdiAddDevice 関数は、DirectX グラフィックスカーネルサブシステムにこのハンドルを提供しました。

[in] VidPnTargetId

新しい保護された出力オブジェクトに対応するビデオの現在のターゲットを一意に識別する整数。各ビデオの現在のターゲットは、1 つの物理モニターコネクタに対応している必要があります。 VidPnTargetId が複数の物理モニターコネクタに対応する場合、DxgkDdiOPMCreateProtectedOutput はSTATUS_GRAPHICS_OPM_SPANNING_MODE_ENABLEDまたはSTATUS_GRAPHICS_OPM_THEATER_MODE_ENABLEDエラーコードを返す必要があります。

[in] NewVideoOutputSemantics

新しい保護された出力に COPP セマンティクスと OPM セマンティクスのどちらが含まれるかを決定する、 DXGKMDT_OPM_VIDEO_OUTPUT_SEMANTICS型指定の値。

[out] NewProtectedOutputHandle

DxgkDdiOPMCreateProtectedOutput が正常に返された場合に、新しい保護された出力オブジェクトへのハンドルを受け取る変数へのポインター。 DirectX グラフィックスカーネルサブシステムは、ディスプレイミニポートドライバーの DxgkDdiOPMGetRandomNumber、 DxgkDdiOPMSetSigningKeyAndSequenceNumbers DxgkDdiOPMGetInformation、 DxgkDdiOPMGetCOPPCompatibleInformation、 DxgkDdiOPMConfigureProtectedOutput、 DxgkDdiOPMDestroyProtectedOutput の呼び出しでこのハンドルを渡します。

DxgkDdiOPMCreateProtectedOutput が失敗した場合、変数の値は変更されません。

戻り値

DxgkDdiOPMCreateProtectedOutput は 、次のいずれかの値を返します。

リターンコード	説明
STATUS_SUCCESS	関数は、保護された新しい出力オブジェクトを正常に作成しました。
STATUS_GRAPHICS_OPM_NOT_SUPPORTED	ディスプレイミニポートドライバーは、ハードウェアベンダーが OPM ライセンス契約に署名しなかったか、ミニポートドライバーのグラフィックスハードウェアが OPM 規則に準拠していないため、OPM をサポートしていません。
STATUS_GRAPHICS_COPP_NOT_SUPPORTED	ディスプレイミニポートドライバーは、ハードウェアベンダーが COPP ライセンス契約に署名していないか、ミニポートドライバーのグラフィックスハードウェアが COPP 規則に準拠していないため、COPP をサポートしていません。
STATUS_NO_MEMORY	DxgkDdiOPMCreateProtectedOutput では、完了するために必要なメモリを割り当てることができません。
STATUS_GRAPHICS_OPM_SPANNING_MODE_ENABLED	DxgkDdiOPMCreateProtectedOutput は、ビデオの現在のターゲットがスパンモードであるため、保護された出力を作成できませんでした。ビデオ表示ターゲットがスパンモードの場合は、複数の物理モニターコネクタに対応し、各コネクタはフレームバッファーの個別の部分を表示します。ディスプレイミニポートドライバーが通常スパニングモードを実装する方法の図については、「解説」セクションを参照してください。ディスプレイミニポートドライバーは、フレームバッファーが特定のモニターにどのように対応するかをオペレーティングシステムに通知します。フレームバッファーの左半分が 1 つのモニターに表示され、フレームバッファーの右半分がもう一方のモニターに表示されます。
STATUS_GRAPHICS_OPM_THEATER_MODE_ENABLED	DxgkDdiOPMCreateProtectedOutput は、ビデオの現在のターゲットがシアターモードであるため、保護された出力を作成できませんでした。ビデオの現在のターゲットがシアターモードの場合は、2 つの物理モニターコネクタに対応します。1 つのコネクタはフレームバッファー全体を表示し、もう 1 つのコネクタはフレームバッファーの一部のみを表示します。シアターモードは、ミラーモードとも呼ばれます。ディスプレイミニポートドライバーが通常、シアターモードを実装する方法の図については、「解説」セクションを参照してください。ディスプレイミニポートドライバーは、フレームバッファーが特定のモニターにどのように対応するかをオペレーティングシステムに通知します。フレームバッファー全体が 1 つのモニターに表示され、もう一方のモニターにはフレームバッファーの一部のみが表示されます。

この関数は、Ntstatus.h で定義されている他のエラーコードも返す場合があります。

注釈

次の図は、ディスプレイミニポートドライバーが通常、スパニングモードを実装する方法を示しています。

次の図は、ディスプレイミニポートドライバーが通常、シアターモードを実装する方法を示しています。シアターモード *DxgkDdiOPMCreateProtectedOutput* をページング可能にする必要があることを示す図

。

要件

要件	値
対象プラットフォーム	デスクトップ
Header	dispmprt.h (Dispmprt.h を含む)
IRQL	PASSIVE_LEVEL (「解説」セクションを参照)