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 結構，指出如何在位字段旗標中鎖定資源。 請注意，某些旗標與其他旗標互斥。 如需詳細資訊，請參閱接下來的＜備註＞一節。
備註
Flags 成員所指定的結構成員必須遵守下列規則：
- ReadOnly 和 WriteOnly 位字段旗標不得同時設定。
- NoOverwrite 位字段旗標不得同時設定為 [捨棄位字段] 旗標。
- 隨時只能設定其中一個 RangeValid、AreaValid 和 BoxValid 位字段旗標。
- ReadOnly 位字段旗標不得同時設定為 [捨棄位字段] 旗標。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
| 標頭 | d3dumddi.h (include D3dumddi.h) |