次の方法で共有


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
ターゲット プラットフォーム デスクトップ
ヘッダー d3dkmddi.h (D3dkmddi.h を含む)
IRQL PASSIVE_LEVEL

関連項目

D3DKMDT_VIDPN_TARGET_MODE

pfnCreateNewModeInfo

pfnReleaseModeInfo