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

[アーティクル]
06/10/2023

pfnGetAdditionalMonitorModeSet 関数は、指定されたモニターに関連付けられている追加のモニターソースモードセットオブジェクトへのハンドルを返します。これは、Windows 7 以降の DXGK_MONITOR_INTERFACE_V2 インターフェイスで使用できます。

構文

DXGKDDI_MONITOR_GETADDITIONALMONITORMODESET DxgkddiMonitorGetadditionalmonitormodeset;

NTSTATUS DxgkddiMonitorGetadditionalmonitormodeset(
  [in]  IN_CONST_D3DKMDT_ADAPTER hAdapter,
  [in]  IN_CONST_D3DDDI_VIDEO_PRESENT_TARGET_ID VideoPresentTargetId,
  [out] OUT_PUINT pNumberModes,
  [out] DEREF_ECOUNT_PPDXGK_TARGETMODE_DETAIL_TIMING ppAdditionalModesSet
)
{...}

パラメーター

[in] hAdapter

ディスプレイアダプターを識別するハンドル。以前、Microsoft DirectX グラフィックスカーネルサブシステムは、DxgkDdiStartDevice 関数の DxgkInterface パラメーターでディスプレイミニポートドライバーにこのハンドルを提供しました。

[in] VideoPresentTargetId

ディスプレイアダプター上のビデオの存在ターゲットの 1 つを識別する整数。返される ppAdditionalModesSet 追加モードセットオブジェクトは、このビデオの現在のターゲットに接続されているモニターで使用できる追加のモニターソースモードセットを表します。

[out] pNumberModes

VideoPresentTargetId で指定されたビデオ存在ターゲットの追加のタイミングモードの数を含む変数へのポインター。

[out] ppAdditionalModesSet

DXGK_TARGETMODE_DETAIL_TIMING構造体へのポインターを受け取る変数へのポインター。この構造は、ディスプレイデバイスと互換性のある、ターゲットの追加のタイミングモードを示すビデオです。

戻り値

pfnAcquireMonitorSourceModeSet 関数は、次のいずれかの値を返します。

リターンコード	説明
STATUS_SUCCESS	関数が正常に実行されました。
STATUS_GRAPHICS_INVALID_DISPLAY_ADAPTER	hAdapter で指定されたハンドルが無効です。
STATUS_GRAPHICS_INVALID_VIDEO_PRESENT_TARGET	VideoPresentTargetId で指定された識別子が無効です。
STATUS_GRAPHICS_MONITOR_NOT_CONNECTED	VideoPresentTargetId によって識別されるビデオの現在のターゲットに接続されているモニターはありません。
STATUS_NOT_FOUND	VideoPresentTargetId によって識別されたビデオの現在のターゲットが見つかりませんでした。

注釈

VidPN ターゲット識別子は、ディスプレイミニポートドライバーによって割り当てられます。ディスプレイミニポートドライバーによって実装される DxgkDdiQueryChildRelations 関数は、識別子を含む DXGK_CHILD_DESCRIPTOR 構造体の配列を返します。

この関数は、Windows 7 以降で使用できます。

要件

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