次の方法で共有

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

  • [アーティクル]

pfnCreateNewModeInfo 関数は、pfnAddMode を呼び出す前に、ディスプレイ ミニポート ドライバーが設定する D3DKMDT_VIDPN_SOURCE_MODE 構造体へのポインター返します。

構文

DXGKDDI_VIDPNSOURCEMODESET_CREATENEWMODEINFO DxgkddiVidpnsourcemodesetCreatenewmodeinfo;

NTSTATUS DxgkddiVidpnsourcemodesetCreatenewmodeinfo(
  [in]  IN_CONST_D3DKMDT_HVIDPNSOURCEMODESET hVidPnSourceModeSet,
  [out] DEREF_OUT_PPD3DKMDT_VIDPN_SOURCE_MODE ppNewVidPnSourceModeInfo
)
{...}

パラメーター

[in] hVidPnSourceModeSet

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

[out] ppNewVidPnSourceModeInfo

VidPN マネージャーによって割り当てられたD3DKMDT_VIDPN_SOURCE_MODE構造体へのポインターを受け取る変数へのポインター。

戻り値

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

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

備考

pfnCreateNewModeInfo 関数は、D3DKMDT_VIDPN_SOURCE_MODE 構造体を割り当て、その ID メンバーを新しく生成された識別子に設定し、Type メンバーを D3DKMDT_RMT_UNINITIALIZEDに設定します。

pfnCreateNewModeInfo 呼び出してD3DKMDT_VIDPN_SOURCE_MODE構造体を取得した後は、次の両方ではなく、いずれかを実行する必要があります。

  • 構造体を設定し、pfnAddMode 渡します。
  • pfnReleaseModeInfo 呼び出して構造体を解放します。
D3DKMDT_VIDPN_SOURCE_MODE構造体を設定するときは、pfnCreateNewModeInfo によって生成および設定された ID メンバー上書きするオプションがあります。 ただし、D3DKMDT_VIDPN_SOURCE_MODE構造体のメンバー ID を上書きする場合は、pfnCreateNewModeInfo から取得したすべてのD3DKMDT_VIDPN_SOURCE_MODE構造体の ID メンバー上書きする必要があります。 ID メンバーを上書きする特定の理由がない限り (たとえば、独自の番号付けスキームでソース モードを追跡する)、pfnCreateNewModeInfo 設定のままにしておく必要があります。

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

必要条件

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

関連項目

D3DKMDT_VIDPN_SOURCE_MODE

pfnAddMode の

pfnReleaseModeInfo の