D3DDDIARG_LOCK结构(d3dumddi.h)
D3DDDIARG_LOCK结构描述要锁定的资源或图面。
语法
typedef struct _D3DDDIARG_LOCK {
[in] HANDLE hResource;
[in] UINT SubResourceIndex;
union {
[in] D3DDDIRANGE Range;
[in] RECT Area;
[in] D3DDDIBOX Box;
};
[out] VOID *pSurfData;
[out] UINT Pitch;
[out] UINT SlicePitch;
[in] D3DDDI_LOCKFLAGS Flags;
} D3DDDIARG_LOCK;
成员
[in] hResource
要锁定的资源的句柄。
[in] SubResourceIndex
资源的从零开始的索引,该索引由由 hResource指定的句柄指定。 此索引指示要锁定的子资源或图面。
[in] Range
描述要锁定的线性资源的子范围D3DDDIRANGE结构。
[in] Area
RECT 结构,用于描述要锁定的图面的子结构。
[in] Box
描述要锁定的卷的子卷的D3DDDIBOX结构。
[out] pSurfData
指向已锁定资源的内存区域的指针。 用户模式显示驱动程序的 Lock 函数返回指向 Microsoft Direct3D 运行时的指针。
[out] Pitch
锁定的图面的间距(以字节为单位)。 用户模式显示驱动程序的 Lock 函数将此音调值返回到 Direct3D 运行时。
[out] SlicePitch
锁定的图面的切片间距(以字节为单位)。 用户模式显示驱动程序的 Lock 函数将此切片间距值返回到 Direct3D 运行时。
[in] Flags
一个 D3DDDI_LOCKFLAGS 结构,指示在位字段标志中如何锁定资源。 请注意,某些标志与其他标志互斥。 有关详细信息,请参阅以下“备注”部分。
言论
标志 成员指定的结构的成员必须遵循以下规则:
- 不得同时设置 ReadOnly 和 WriteOnly 位字段标志。
- NoOverwrite 位字段标志不得与 放弃 位字段标志同时设置。
- 必须随时设置 RangeValid、AreaValid和 BoxValid 位字段标志之一。
- ReadOnly 位字段标志不得与 放弃 位字段标志同时设置。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows Vista 和更高版本的 Windows作系统中可用。 |
标头 | d3dumddi.h (包括 D3dumddi.h) |