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

在多采样图面中呈现样本的质量级别。 质量级别必须是一个介于 0 到 7 的数字,分别表示从 1 到 8 的质量级别。

请注意,即使图面不是多采样 (即,如果在 MultisampleType) 指定了D3DDDIMULTISAMPLE_NONE,它仍然可以具有大于 1 ((通过使用大于 0) 的数字指定) 的质量级别。

[in] pSurfList

一个D3DDDI_SURFACEINFO结构的数组,用于 (或) 要创建的其他资源类型的图面列表。

[in] SurfCount

数组中由 pSurfList 成员指定的资源数。

[in] MipLevels

资源的 MIP 映射级别数。

[in] Fvf

顶点缓冲区的 FVF 格式。

[in] VidPnSourceId

视频呈现网络路径中视频当前源的从零开始的标识号 (VidPN) 拓扑,如果资源包含主图面) ,则主图面是在 (创建的。

[in] RefreshRate

一个D3DDDI_RATIONAL结构,用于指定用于资源的刷新率。 仅当资源是主图面且未在 Flags 成员中设置 MatchGdiPrimary 位字段标志时,此成员才适用。 此外,如果在 Flags 中设置了 InterlacedRefresh 位字段标志,则用户模式显示驱动程序将确定刷新率交错 (否则,渐进式) 。

[in/out] hResource

资源的句柄。 在 输入 CreateResource 函数时, hResource 指定驱动程序在调用回 Microsoft Direct3D 运行时时应使用的句柄。

驱动程序生成唯一句柄,并将其传递回 Direct3D 运行时。 在 CreateResource 函数的输出中, hResource 指定 Direct3D 运行时应在后续驱动程序调用中使用的句柄来标识资源。

[in] Flags

标识要创建的资源类型的 D3DDDI_RESOURCEFLAGS 结构。 请注意, D3DDDI_RESOURCEFLAGS 中的某些位字段标志也需要设置其他位字段标志。

[in] Rotation

一个D3DDDI_ROTATION类型的值,用于标识资源的方向。

例如,假设用户模式显示驱动程序收到请求,要求将 480x640 表面旋转 90 度 (D3DDDI_ROTATION_90) 。 驱动程序应在 640x480 模式下分配图面以进行扫描。 呈现到图面时,驱动程序应执行 90 度旋转。

仅当主位字段标志也在 Flags 成员中设置时,才会设置除D3DDDI_ROTATION_IDENTITY以外的方向。

要求

要求
最低受支持的客户端 在 Windows Vista 和更高版本的 Windows 操作系统中可用。
标头 d3dukmdt.h (包括 D3dumddi.h、D3dkmddi.h)

另请参阅

CreateResource

D3DDDIFORMAT

D3DDDIMULTISAMPLE_TYPE

D3DDDI_POOL

D3DDDI_RATIONAL

D3DDDI_ROTATION

D3DDDI_SURFACEINFO