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

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

構文

DXGKDDI_VIDPNSOURCEMODESET_ADDMODE DxgkddiVidpnsourcemodesetAddmode;

NTSTATUS DxgkddiVidpnsourcemodesetAddmode(
  [in] IN_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [in] IN_PD3DKMDT_VIDPN_SOURCE_MODE_CONST pVidPnSourceModeInfo
)
{...}

パラメーター

[in] hVidPnSourceModeSet

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

[in] pVidPnSourceModeInfo

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

戻り値

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

リターン コード	形容
STATUS_SUCCESS	関数は成功しました。
STATUS_GRAPHICS_INVALID_VIDPN_SOURCEMODESET	hVidPnSourceModeSet で指定されたハンドルが無効でした。

備考

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

pfnCreateNewModeInfo 呼び出して、D3DKMDT_VIDPN_SOURCE_MODE 構造体へのポインターを取得します。 pnfCreateNewModeInfo 関数は、構造体を割り当て、ID メンバーに新しく生成されたソース モード識別子を入力し、Type メンバーを D3DKMDT_RMT_UNINITIALIZEDに設定します。

モードの種類や形式など、D3DKMDT_VIDPN_SOURCE_MODE構造体 (ID メンバーを除く) にモードに関する情報を設定します。

pfnAddMode 呼び出して、ソース モード セットにモードを追加します。

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

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

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

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
ターゲット プラットフォーム の	デスクトップ
ヘッダー	d3dkmddi.h (D3dkmddi.h を含む)
IRQL	PASSIVE_LEVEL

関連項目

D3DKMDT_VIDPN_SOURCE_MODE

pfnCreateNewModeInfo の

pfnReleaseModeInfo の