Auf Englisch lesen

Freigeben über


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

Anforderungen

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

Weitere Informationen

IDirect3DVolumeTexture9

UnlockBox