IDirect3DVolume9::LockBox-Methode (d3d9.h)

Artikel
08/23/2023

Sperrt ein Feld für eine Volumeressource.

Syntax

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

Parameter

[out] pLockedVolume

Typ: D3DLOCKED_BOX*

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

[in] pBox

Typ: const D3DBOX*

Zeiger auf ein zu sperrende Feld. Wird durch einen Zeiger auf eine D3DBOX-Struktur angegeben. Die Angabe von NULL für diesen Parameter sperrt das gesamte Volume.

[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

Eine Beschreibung der Flags finden Sie unter D3DLOCK.

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 IDirect3DVolume9::LockBox ohne D3DLOCK_NO_DIRTY_UPDATE oder D3DLOCK_READONLY aufgerufen wird. Weitere Informationen finden Sie unter IDirect3DDevice9::UpdateTexture .

Anforderungen


Zielplattform	Windows
Kopfzeile	d3d9.h (einschließlich D3D9.h)
Bibliothek	D3D9.lib

Weitere Informationen

IDirect3DVolume9

IDirect3DVolume9::UnlockBox

Freigeben über