D3DDDIARG_OPENRESOURCE 结构 (d3dumddi.h)

  • 项目

D3DDDIARG_OPENRESOURCE 结构包含用于打开共享资源的信息。

语法

typedef struct _D3DDDIARG_OPENRESOURCE {
  [in]     UINT                      NumAllocations;
  union {
    [in]     D3DDDI_OPENALLOCATIONINFO  *pOpenAllocationInfo;
             D3DDDI_OPENALLOCATIONINFO2 *pOpenAllocationInfo2;
  };
  [in]     D3DDDI_OPENALLOCATIONINFO *pOpenAllocationInfo;
  [in]     D3DKMT_HANDLE             hKMResource;
  [in]     VOID                      *pPrivateDriverData;
  [in]     UINT                      PrivateDriverDataSize;
  [in/out] HANDLE                    hResource;
  [in]     D3DDDI_ROTATION           Rotation;
  [in]     D3DDDI_OPENRESOURCEFLAGS  Flags;
} D3DDDIARG_OPENRESOURCE;

成员

[in] NumAllocations

数组中由 pOpenAllocationInfo 指定的元素数。 NumAllocations 表示要打开的分配数。

[in] pOpenAllocationInfo

描述要打开的资源中的分配的 D3DDDI_OPENALLOCATIONINFO 结构的数组。

[in]描述要打开的资源中的分配的 D3DDDI_OPENALLOCATIONINFO 结构的数组。

pOpenAllocationInfo2

此成员是保留成员，应设置为零。

此成员从 Windows 7 开始可用。

[in] hKMResource

D3DKMT_HANDLE数据类型，表示与分配关联的资源的内核模式句柄。

此内核模式句柄表示先前通过调用用户模式显示驱动程序的 CreateResource 函数创建的现有共享资源。

[in] pPrivateDriverData

指向在创建资源时传递给显示微型端口驱动程序的专用数据的指针。 此数据是每个资源的数据，而不是每个分配 D3DDDI_OPENALLOCATIONINFO结构中的 专用数据。

[in] PrivateDriverDataSize

pPrivateDriverData 指向的私有数据的大小（以字节为单位）。

[in/out] hResource

与分配关联的资源的句柄。

用户模式显示驱动程序应保存此句柄，并在驱动程序调用回 Microsoft Direct3D 运行时时使用它来标识资源。 用户模式显示驱动程序应生成唯一句柄并将其传递回 Direct3D 运行时。 Direct3D 运行时在驱动程序调用中使用此句柄来标识资源。

[in] Rotation

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

当主资源与全屏设备一起使用并旋转时，可能需要驱动程序创建临时分配来处理全屏设备。 在 Flags 成员中设置全屏位域标志，以指示主资源与全屏设备一起使用。

[in] Flags

标识要打开的资源类型的 D3DDDI_OPENRESOURCEFLAGS 结构。

注解

在调用 CreateResource 函数以创建共享主资源时，在 D3DDDIARG_CREATERESOURCE 结构的 Flags 成员中设置 Primary 和 SharedResource 位字段标志。

要求

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

另请参阅

CreateResource

D3DDDIARG_CREATERESOURCE

D3DDDI_OPENALLOCATIONINFO

D3DDDI_OPENRESOURCEFLAGS

D3DDDI_ROTATION

OpenResource