DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH コールバック関数 (d3dkmddi.h)

  • [アーティクル]

DxgkDdiUpdateActiveVidPnPresentPath 関数は、ディスプレイ アダプターで現在アクティブになっているビデオの現在のパスの 1 つを更新します。

構文

DXGKDDI_UPDATEACTIVEVIDPNPRESENTPATH DxgkddiUpdateactivevidpnpresentpath;

NTSTATUS DxgkddiUpdateactivevidpnpresentpath(
       IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_UPDATEACTIVEVIDPNPRESENTPATH_CONST pUpdateActiveVidPnPresentPath
)
{...}

パラメーター

hAdapter

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

[in] pUpdateActiveVidPnPresentPath

D3DKMDT_VIDPN_PRESENT_PATH構造体という 1 つのメンバーを含む、DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH構造体へのポインター。 D3DKMDT_VIDPN_PRESENT_PATH構造体のメンバーは、パスを識別し、パスの新しい設定を指定します。 DxgkDdiUpdateActiveVidPnPresentPath 関数は、新しい設定に従ってディスプレイ アダプターのパスをプログラムする必要があります。

戻り値

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

値 説明
STATUS_SUCCESS 関数が正常に実行されました。
STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo> で指定されたパスは、アクティブな VidPN のトポロジ内にありません。
STATUS_GRAPHICS_PATH_CONTENT_GEOMETRY_TRANSFORMATION_NOT_SUPPORTED パスは、pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo.ContentTransformation> で指定されたコンテンツ変換をサポートしていません。 パスは、pUpdateActiveVidPnPresentPathArg-VidPnPresentPathInfo.GammaRamp> で指定されたガンマ ランプをサポートしていません。

注釈

オペレーティング システムは DxgkDdiUpdateActiveVidPnPresentPath 関数を呼び出して、パスの回転、提示されたコンテンツのジオメトリ変換、表示されるコンテンツの明るさの調整に使用されるガンマ ランプなど、ビデオの現在のパスの設定を制御します。

メモ ディスプレイ ミニポート ドライバーの DxgkDdiUpdateActiveVidPnPresentPath 関数は、ガンマ ランプをサポートする必要があります。
 
Windows 8以降、ディスプレイ ミニポート ドライバーがDXGK_DRIVERCAPS構造体の SupportSmoothRotation メンバーを設定する場合は、DxgkDdiUpdateActiveVidPnPresentPath 関数を使用してアダプターのパス回転の更新をサポートする必要があります。 ドライバーは、 DxgkDdiCommitVidPn 関数の呼び出し中に常にパスの回転を設定できる必要があります。

DxgkDdiUpdateActiveVidPnPresentPath 関数をページング可能にする必要があります。

要件

要件 値
サポートされている最小のクライアント Windows Vista
対象プラットフォーム デスクトップ
Header d3dkmddi.h
IRQL PASSIVE_LEVEL

こちらもご覧ください

D3DKMDT_VIDPN_PRESENT_PATH

DXGKARG_UPDATEACTIVEVIDPNPRESENTPATH

DXGK_DRIVERCAPS

DxgkDdiAddDevice

DxgkDdiCommitVidPn