IDirect3DVolumeTexture9::LockBox-Methode (d3d9.h)

Sperrt ein Feld für eine Volumetexturressource.

Syntax

HRESULT LockBox(
  [in]  UINT          Level,
  [out] D3DLOCKED_BOX *pLockedVolume,
  [in]  const D3DBOX  *pBox,
  [in]  DWORD         Flags
);

Parameter

[in] Level

Typ: UINT

Gibt die Ebene der zu sperrenden Volumetexturressource an.

[out] pLockedVolume

Typ: D3DLOCKED_BOX*

Zeiger auf eine D3DLOCKED_BOX-Struktur , die den gesperrten Bereich beschreibt.

[in] pBox

Typ: const D3DBOX*

Zeiger auf das zu sperrende Volume. Dieser Parameter wird durch einen Zeiger auf eine D3DBOX-Struktur angegeben. Die Angabe von NULL für diesen Parameter sperrt die gesamte Volumeebene.

[in] Flags

Typ: DWORD

Kombination aus 0 oder mehr Sperrflags, die den Typ der auszuführenden Sperre beschreiben. Für diese Methode sind die folgenden Flags gültig:

• D3DLOCK_DISCARD
• D3DLOCK_NO_DIRTY_UPDATE
• D3DLOCK_NOSYSLOCK
• D3DLOCK_READONLY

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. Wenn die Methode fehlschlägt, kann der Rückgabewert D3DERR_INVALIDCALL werden.

Hinweise

Aus Leistungsgründen werden modifiziert Regionen nur für ebene null einer Textur aufgezeichnet. Fehlerhafte Regionen werden automatisch aufgezeichnet, wenn LockBox ohne D3DLOCK_NO_DIRTY_UPDATE oder D3DLOCK_READONLY aufgerufen wird. Weitere Informationen finden Sie unter UpdateTexture.

Anforderungen

Weitere Informationen

IDirect3DVolumeTexture9

UnlockBox