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 で指定されたハンドルが無効でした。 |
備考
ターゲット モード セットにモードを追加するには、ディスプレイ ミニポート ドライバーは、次の手順を実行します。
- pfnCreateNewModeInfo 呼び出して、D3DKMDT_VIDPN_TARGET_MODE 構造体へのポインターを取得します。 pnfCreateNewModeInfo 関数は構造体を割り当て、ID メンバーに新しく生成されたターゲット モード識別子を入力します。
- D3DKMDT_VIDPN_TARGET_MODE構造体の Info メンバーは、D3DKMDT_VIDEO_SIGNAL_MODE 構造体です。 その構造体にモードに関する情報を設定します。
- pfnAddMode 呼び出して、ターゲット モード セットにモードを追加します。
pfnCreateNewModeInfo 呼び出してD3DKMDT_VIDPN_TARGET_MODE構造体を取得し、そのモードをターゲット モード セットに追加しない場合は、pfnReleaseModeInfo 呼び出して構造体を明示的に解放する必要があります。
D3DKMDT_HVIDPNTARGETMODESET データ型は、D3dkmdt.hで定義されています。
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows Vista |
ターゲット プラットフォーム の | デスクトップ |
ヘッダー | d3dkmddi.h (D3dkmddi.h を含む) |
IRQL | PASSIVE_LEVEL |
関連項目
pfnCreateNewModeInfo の
pfnReleaseModeInfo の