D3DDDIARG_LOCK Struktur (d3dumddi.h)

Artikel
02/06/2025

Die D3DDDIARG_LOCK-Struktur beschreibt eine Ressource oder eine Oberfläche innerhalb der zu sperrenden Ressource.

Syntax

typedef struct _D3DDDIARG_LOCK {
  [in]  HANDLE           hResource;
  [in]  UINT             SubResourceIndex;
  union {
    [in]  D3DDDIRANGE Range;
    [in]  RECT        Area;
    [in]  D3DDDIBOX   Box;
  };
  [out] VOID             *pSurfData;
  [out] UINT             Pitch;
  [out] UINT             SlicePitch;
  [in]  D3DDDI_LOCKFLAGS Flags;
} D3DDDIARG_LOCK;

Angehörige

[in] hResource

Ein Handle für die zu sperrende Ressource.

[in] SubResourceIndex

Der nullbasierte Index in der Ressource, der durch das handle angegeben wird, das durch hResourceangegeben wird. Dieser Index gibt die zu sperrende Unterressource oder Oberfläche an.

[in] Range

Eine D3DDDIRANGE Struktur, die die Unterrange der zu sperrenden linearen Ressource beschreibt.

[in] Area

Eine RECT- Struktur, die das Unterrechteck der zu sperrenden Oberfläche beschreibt.

[in] Box

Eine D3DDDIBOX Struktur, die das Untervolume des zu sperrenden Volumes beschreibt.

[out] pSurfData

Ein Zeiger auf den Speicherbereich für die Ressource, die gesperrt wurde. Die Lock-Funktion des Benutzermodus zeigt diesen Zeiger auf die Microsoft Direct3D-Laufzeit zurück.

[out] Pitch

Die Neigung in Byte der Oberfläche, die gesperrt wurde. Die Lock-Funktion des Benutzermodus zeigt diesen Pitchwert an die Direct3D-Laufzeit zurück.

[out] SlicePitch

Der Segmentabstand in Bytes der gesperrten Oberfläche. Die Lock-Funktion des Benutzermodus zeigt diesen Segmentabstandswert an die Direct3D-Laufzeit zurück.

[in] Flags

Eine D3DDDI_LOCKFLAGS Struktur, die in Bitfeldkennzeichnungen angibt, wie die Ressource gesperrt wird. Beachten Sie, dass einige Flags sich gegenseitig mit anderen Flags ausschließen. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Bemerkungen

Die Elemente der Struktur, die durch die Flags Member angegeben wird, müssen die folgenden Regeln einhalten:

Die ReadOnly und WriteOnly- Bitfeldkennzeichnungen dürfen nicht gleichzeitig festgelegt werden.
Das NoOverwrite- Bitfeld-Flag darf nicht gleichzeitig mit dem "Verwerfen Bitfeldflagge" festgelegt werden.
Es müssen jeweils nur eine der RangeValid-, AreaValid-und BoxValid- Bitfeldflaggen festgelegt werden.
Das "ReadOnly" Bitfeldflagge darf nicht gleichzeitig mit der "Verwerfen" Bitfeldkennzeichnung festgelegt werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Header-	d3dumddi.h (include D3dumddi.h)

Siehe auch

D3DDDI_LOCKFLAGS

Sperren

Freigeben über