共用方式為


IDirect3DCubeTexture9::LockRect 方法 (d3d9helper.h)

鎖定 Cube 紋理資源上的矩形。

語法

HRESULT LockRect(
  [in]  D3DCUBEMAP_FACES FaceType,
  [in]  UINT             Level,
  [out] D3DLOCKED_RECT   *pLockedRect,
  [in]  const RECT       *pRect,
  [in]  DWORD            Flags
);

參數

[in] FaceType

類型: D3DCUBEMAP_FACES

識別 Cube 地圖臉部 之D3DCUBEMAP_FACES 列舉型別的成員。

[in] Level

類型: UINT

指定 Mipmapped Cube 紋理的層級。

[out] pLockedRect

類型: D3DLOCKED_RECT*

D3DLOCKED_RECT結構的指標,描述要鎖定的區域。

[in] pRect

類型: const RECT*

要鎖定之矩形的指標。 由 RECT 結構的指標指定。 指定此參數的 NULL 會展開已變更的區域,以涵蓋整個 Cube 紋理。

[in] Flags

類型: DWORD

描述要執行的鎖定類型之零個或多個鎖定旗標的組合。 針對這個方法,有效的旗標為:

  • D3DLOCK_DISCARD
  • D3DLOCK_NO_DIRTY_UPDATE
  • D3DLOCK_NOSYSLOCK
  • D3DLOCK_READONLY
使用 D3DLOCK_DISCARD 時,您可能不會指定子專案。 如需旗標的描述,請參閱 D3DLOCK

傳回值

類型: HRESULT

如果方法成功,傳回值會D3D_OK。 如果一或多個自變數無效,則會傳回D3DERR_INVALIDCALL。

備註

基於效能考慮,已變更的區域只會針對紋理的層級零進行記錄。 在呼叫 IDirect3DCubeTexture9::LockRect 時,系統會自動記錄變更區域,而不需D3DLOCK_NO_DIRTY_UPDATE或D3DLOCK_READONLY。 如需詳細資訊 ,請參閱 IDirect3DDevice9::UpdateTexture

使用 D3DPOOL_DEFAULT 建立的 Cube 紋理無法鎖定。 使用 USAGE_DYNAMIC 建立時,可鎖定在視訊記憶體中建立的 Cube 紋理。

深度樣板紋理的唯一可鎖定格式是 D3DFMT_D16_LOCKABLE

規格需求

需求
目標平台 Windows
標頭 d3d9helper.h (包含 D3D9.h)
程式庫 D3D9.lib

另請參閱

IDirect3DCubeTexture9

IDirect3DCubeTexture9::AddDirtyRect

IDirect3DCubeTexture9::GetLevelDesc

IDirect3DCubeTexture9::UnlockRect