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 位欄位字段旗標不得與 Discard 位字段旗標同時設定。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows作系統中使用。 |
| 標頭 | d3dumddi.h （包括 D3dumddi.h） |