D3DDDIARG_CREATERESOURCE2 结构 (d3dukmdt.h)

  • 项目

包含用于创建资源的信息。 由 Windows 显示驱动程序模型 (WDDM) 1.2 及更高版本的用户模式显示驱动程序使用。

语法

typedef struct _D3DDDIARG_CREATERESOURCE2 {
  [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;
  [in]     D3DDDI_RESOURCEFLAGS2          Flags2;
} D3DDDIARG_CREATERESOURCE2;

成员

[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

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

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

[in] Flags

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

[in] Rotation

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

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

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

[in] Flags2

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

要求

要求 值
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
标头 d3dukmdt.h (包括 D3dukmdt.h、D3dkmddi.h)

另请参阅

CreateResource2

D3DDDIFORMAT

D3DDDIMULTISAMPLE_TYPE

D3DDDI_POOL

D3DDDI_RATIONAL

D3DDDI_RESOURCEFLAGS2

D3DDDI_ROTATION

D3DDDI_SURFACEINFO