IDirect3DCubeTexture9::LockRect-Methode (d3d9.h)

Artikel
08/23/2023

Sperrt ein Rechteck für eine Cubetexturressource.

Syntax

HRESULT LockRect(
  [in]  D3DCUBEMAP_FACES FaceType,
  [in]  UINT             Level,
  [out] D3DLOCKED_RECT   *pLockedRect,
  [in]  const RECT       *pRect,
  [in]  DWORD            Flags
);

Parameter

[in] FaceType

Typ: D3DCUBEMAP_FACES

Mitglied des D3DCUBEMAP_FACES aufgezählten Typs, der eine Cubezuordnungsseite identifiziert.

[in] Level

Typ: UINT

Gibt eine Ebene einer mipmappenierten Cubetextur an.

[out] pLockedRect

Typ: D3DLOCKED_RECT*

Zeiger auf eine D3DLOCKED_RECT-Struktur , in der die zu sperrende Region beschrieben wird.

[in] pRect

Typ: const RECT*

Zeiger auf ein zu sperrende Rechteck. Wird durch einen Zeiger auf eine RECT-Struktur angegeben. Durch Angeben von NULL für diesen Parameter wird der modifiziert Bereich erweitert, um die gesamte Cubetextur abzudecken.

[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

Sie dürfen keine Unterect angeben, wenn Sie D3DLOCK_DISCARD verwenden. Eine Beschreibung der Flags finden Sie unter D3DLOCK.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabewert D3D_OK. D3DERR_INVALIDCALL wird zurückgegeben, wenn mindestens eines der Argumente ungültig ist.

Hinweise

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

Mit D3DPOOL_DEFAULT erstellte Cubetexturen können nicht gesperrt werden. Cubetexturen, die im Videospeicher erstellt werden, können gesperrt werden, wenn sie mit USAGE_DYNAMIC erstellt werden.

Das einzige sperrbare Format für eine Tiefenschablonentextur ist D3DFMT_D16_LOCKABLE.