IDirect3DCubeTexture9::LockRect-Methode (d3d9.h)

Artikel
09/27/2022
2 Minuten Lesedauer

Sperrt ein Rechteck auf einer Cube-Texturressource.

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

Member des D3DCUBEMAP_FACES aufgezählten Typs, der ein Cubezuordnungs-Gesicht identifiziert.

[in] Level

Typ: UINT

Gibt eine Ebene einer Mipmappenwürfeltextur an.

[out] pLockedRect

Typ: D3DLOCKED_RECT*

Zeiger auf eine D3DLOCKED_RECT Struktur, die den zu sperrenden Bereich beschreibt.

[in] pRect

Typ: Const RECT*

Zeiger auf ein Rechteck zum Sperren. Angegeben durch einen Zeiger auf eine RECT-Struktur . Wenn Sie NULL für diesen Parameter angeben, wird der schmutzige Bereich erweitert, um die gesamte Cubetextur abzudecken.

[in] Flags

Typ: DWORD

Kombination aus Null- oder mehr Sperrzeichen, die den Typ der zu ausführenden Sperrung beschreiben. Für diese Methode sind die gültigen Flags:

D3DLOCK_DISCARD
D3DLOCK_NO_DIRTY_UPDATE
D3DLOCK_NOSYSLOCK
D3DLOCK_READONLY

Sie können beim Verwenden von D3DLOCK_DISCARD möglicherweise keine Unterkorrektur angeben. Eine Beschreibung der Flags finden Sie unter D3DLOCK.

Rückgabewert

Typ: HRESULT

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

Hinweise

Aus Leistungsgründen werden schmutzige 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 .

Cube-Texturen, die mit D3DPOOL_DEFAULT erstellt wurden, sind nicht sperrbar. Cube-Texturen, die im Videospeicher erstellt wurden, können beim Erstellen mit USAGE_DYNAMIC gesperrt werden.

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