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

pfnAddMode 関数は、指定された VidPN ターゲット モード セット オブジェクトに VidPN ターゲット モードを追加します。

構文

DXGKDDI_VIDPNTARGETMODESET_ADDMODE DxgkddiVidpntargetmodesetAddmode;

NTSTATUS DxgkddiVidpntargetmodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNTARGETMODESET hVidPnTargetModeSet,
  [in] IN_PD3DKMDT_VIDPN_TARGET_MODE_CONST pVidPnTargetModeInfo
)
{...}

パラメーター

[in] hVidPnTargetModeSet

VidPN ターゲット モード セット オブジェクトへのハンドル。 ディスプレイ ミニポート ドライバーは、DXGK_VIDPN_INTERFACE インターフェイスのpfnAcquireTargetModeSet 関数を呼び出すことによって、このハンドルを以前に取得しました。

[in] pVidPnTargetModeInfo

ターゲット モードを記述 するD3DKMDT_VIDPN_TARGET_MODE 構造体へのポインター。 ディスプレイ ミニポート ドライバーは、 pfnCreateNewModeInfo を呼び出すことによって、この構造体を以前に取得しました。

戻り値

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

リターン コード	説明
STATUS_SUCCESS	関数が正常に実行されました。
STATUS_GRAPHICS_INVALID_VIDPN_TARGETMODESET	hVidPnTargetModeSet で指定されたハンドルが無効です。

注釈

ターゲット モード セットにモードを追加するには、ディスプレイ ミニポート ドライバーは、次の手順を実行します。

1. pfnCreateNewModeInfo を呼び出して、D3DKMDT_VIDPN_TARGET_MODE構造体へのポインターを取得します。 pnfCreateNewModeInfo 関数は構造体を割り当て、Id メンバーに新しく生成されたターゲット モード識別子を入力します。
2. D3DKMDT_VIDPN_TARGET_MODE構造体の Info メンバーは 、D3DKMDT_VIDEO_SIGNAL_MODE 構造体です。 モードに関する情報を構造体に設定します。
3. pfnAddMode を呼び出して、ターゲット モード セットにモードを追加します。

pfnCreateNewModeInfo を呼び出すと、VidPN マネージャーによってD3DKMDT_VIDPN_TARGET_MODE構造体が割り当てられます。 その構造体で記述されているモードをターゲット モード セットに追加する場合は、構造体を明示的に解放する必要はありません。 pfnAddMode によって 解放されます。

pfnCreateNewModeInfo を呼び出してD3DKMDT_VIDPN_TARGET_MODE構造体を取得し、そのモードをターゲット モード セットに追加しない場合は、pfnReleaseModeInfo を呼び出して構造体を明示的に解放する必要があります。

D3DKMDT_HVIDPNTARGETMODESETデータ型は D3dkmdt.h で定義されています。

要件

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

こちらもご覧ください

D3DKMDT_VIDPN_TARGET_MODE

pfnCreateNewModeInfo

pfnReleaseModeInfo