IDirect3DVolumeTexture9::LockBox-Methode (d3d9.h)
Sperrt ein Feld für eine Volumetexturressource.
HRESULT LockBox(
[in] UINT Level,
[out] D3DLOCKED_BOX *pLockedVolume,
[in] const D3DBOX *pBox,
[in] DWORD Flags
);
[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
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.
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.
Zielplattform | Windows |
Kopfzeile | d3d9.h (einschließlich D3D9.h) |
Bibliothek | D3D9.lib |