IDirect3DCubeTexture9：：LockRect 方法 (d3d9.h)

發行項
08/23/2023

鎖定 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

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

[in] Level

類型： UINT

指定已套用立方體紋理的層級。

[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。