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) |