D3DDDIARG_CREATERESOURCE構造体 (d3dukmdt.h)

  • [アーティクル]

D3DDDIARG_CREATERESOURCE構造体には、リソースを作成するための情報が含まれています。

構文

typedef struct _D3DDDIARG_CREATERESOURCE {
  [in]     D3DDDIFORMAT                   Format;
  [in]     D3DDDI_POOL                    Pool;
  [in]     D3DDDIMULTISAMPLE_TYPE         MultisampleType;
  [in]     UINT                           MultisampleQuality;
  [in]     const D3DDDI_SURFACEINFO       *pSurfList;
  [in]     UINT                           SurfCount;
  [in]     UINT                           MipLevels;
  [in]     UINT                           Fvf;
  [in]     D3DDDI_VIDEO_PRESENT_SOURCE_ID VidPnSourceId;
  [in]     D3DDDI_RATIONAL                RefreshRate;
  [in/out] HANDLE                         hResource;
  [in]     D3DDDI_RESOURCEFLAGS           Flags;
  [in]     D3DDDI_ROTATION                Rotation;
} D3DDDIARG_CREATERESOURCE;

メンバー

[in] Format

リソースの形式を示す D3DDDIFORMAT型指定の値。

[in] Pool

リソースが作成されるメモリ プールの種類を示す、 D3DDDI_POOL型指定された値。

[in] MultisampleType

複数サンプリング サーフェスのサンプル数を示すD3DDDIMULTISAMPLE_TYPE型指定された値。 サーフェスが複数サンプリングされていない場合、この値は D3DDDIMULTISAMPLE_NONE (0) になります。

[in] MultisampleQuality

複数サンプリングされたサーフェス内のレンダリング サンプルの品質レベル。 品質レベルは、それぞれ 1 ~ 8 の品質レベルを表す 0 ~ 7 の数値である必要があります。

サーフェスが複数サンプリングされていない場合でも (つまり、multisampleType でD3DDDIMULTISAMPLE_NONEが指定されている場合)、品質レベルは 1 より大きい (0 より大きい数値を使用して指定されます) 可能性があることに注意してください。

[in] pSurfList

作成 する サーフェス (またはその他のリソースの種類) の一覧のD3DDDI_SURFACEINFO構造体の配列。

[in] SurfCount

pSurfList メンバーによって指定された配列内のリソースの数。

[in] MipLevels

リソースの MIP マップ レベルの数。

[in] Fvf

頂点バッファーの FVF 形式。

[in] VidPnSourceId

プライマリ サーフェスが作成されるビデオ プレゼンテーション ネットワーク (VidPN) トポロジのパス内にあるビデオ 存在ソースの 0 から始まる識別番号 (リソースにプライマリ サーフェスが含まれている場合)。

[in] RefreshRate

リソース が 使用される更新レートを指定するD3DDDI_RATIONAL構造体。 このメンバーは、リソースがプライマリ サーフェスであり、 MatchGdiPrimary ビット フィールド フラグが Flags メンバーに設定されていない場合にのみ適用されます。 さらに、 InterlacedRefresh ビット フィールド フラグが Flags で設定されている場合、ユーザー モードディスプレイ ドライバーは、リフレッシュ レートがインターリーブ (それ以外の場合はプログレッシブ) であると判断します。

[in/out] hResource

リソースへのハンドル。 CreateResource 関数への入力時に、hResource は、ドライバーが Microsoft Direct3D ランタイムに呼び戻す場合に使用するハンドルを指定します。

ドライバーは一意のハンドルを生成し、Direct3D ランタイムに渡します。 CreateResource 関数からの出力時に、hResource は、Direct3D ランタイムが後続のドライバー呼び出しで使用してリソースを識別するハンドルを指定します。

[in] Flags

作成するリソースの種類を識別するD3DDDI_RESOURCEFLAGS構造体。 D3DDDI_RESOURCEFLAGSのビット フィールド フラグの一部では、追加のビット フィールド フラグも設定する必要があることに注意してください。

[in] Rotation

リソースの向きを識別する D3DDDI_ROTATION型指定の値。

たとえば、ユーザー モード ディスプレイ ドライバーが 90 度 (D3DDDI_ROTATION_90) 回転する 480 x 640 サーフェスの要求を受け取ったとします。 ドライバーは、スキャン目的で 640 x 480 モードでサーフェスを割り当てる必要があります。 サーフェスにレンダリングする場合、ドライバーは 90 度回転を実行する必要があります。

D3DDDI_ROTATION_IDENTITY以外の方向は、Flags メンバーでプライマリ ビット フィールド フラグも設定されている場合にのみ設定されます。

要件

要件 値
サポートされている最小のクライアント Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。
Header d3dukmdt.h (D3dumddi.h、D3dkmddi.h を含む)

こちらもご覧ください

CreateResource

D3DDDIFORMAT

D3DDDIMULTISAMPLE_TYPE

D3DDDI_POOL

D3DDDI_RATIONAL

D3DDDI_ROTATION

D3DDDI_SURFACEINFO