IDirect3DVolume9::LockBox-Methode (d3d9helper.h)

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 von 0 oder mehr Sperrflags, die den Typ der auszuführenden Sperre beschreiben. Für diese Methode gelten die folgenden Flags:

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

Anforderungen

Weitere Informationen

IDirect3DVolume9

IDirect3DVolume9::UnlockBox