IDirect3DIndexBuffer9::Lock 方法 (d3d9.h)
鎖定索引數據的範圍,並取得索引緩衝區內存的指標。
語法
HRESULT Lock(
[in] UINT OffsetToLock,
[in] UINT SizeToLock,
[out] void **ppbData,
[in] DWORD Flags
);
參數
[in] OffsetToLock
類型: UINT
位移至索引數據,以位元組為單位鎖定。 針對參數、SizeToLock 和 OffsetToLock 指定 0,以鎖定整個索引緩衝區。
[in] SizeToLock
類型: UINT
要鎖定的索引數據大小,以位元組為單位。 針對參數、SizeToLock 和 OffsetToLock 指定 0,以鎖定整個索引緩衝區。
[out] ppbData
類型: VOID**
VOID* 記憶體緩衝區的指標,其中包含傳回的索引數據。
[in] Flags
類型: DWORD
零個或多個鎖定旗標的組合,描述要執行的鎖定類型。 針對這個方法,有效的旗標為:
- D3DLOCK_DISCARD
- D3DLOCK_NO_DIRTY_UPDATE
- D3DLOCK_NOSYSLOCK
- D3DLOCK_READONLY
- D3DLOCK_NOOVERWRITE
傳回值
類型: HRESULT
如果方法成功,傳回值會D3D_OK。 如果方法失敗,則傳回值可以D3DERR_INVALIDCALL。
備註
一般規則是,不要在多個畫面上保留鎖定。 使用索引緩衝區時,您可以進行多個鎖定呼叫。 不過,您必須確定鎖定呼叫數目符合解除鎖定呼叫的數目。 IDirect3DDevice9::D rawIndexedPrimitive 呼叫將不會成功,且任何目前設定的索引緩衝區上有任何未完成的鎖定計數。
D3DLOCK_DISCARD和D3DLOCK_NOOVERWRITE旗標只有在以 D3DUSAGE_DYNAMIC 建立的緩衝區上才有效。
如需使用 D3DLOCK_DISCARD 或 D3DLOCK_NOOVERWRITE 的相關信息,請參閱 Direct3D 9) 程式設計 (秘訣 。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | d3d9.h (包含 D3D9.h) |
程式庫 | D3D9.lib |