D3DDDIARG_LOCKASYNC Struktur (d3dumddi.h)

Artikel
02/06/2025

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

Syntax

typedef struct _D3DDDIARG_LOCKASYNC {
  [in]  HANDLE                 hResource;
  [in]  UINT                   SubResourceIndex;
  [in]  D3DDDI_LOCKASYNCFLAGS  Flags;
  union {
    [in]  D3DDDIRANGE Range;
    [in]  RECT        Area;
    [in]  D3DDDIBOX   Box;
  };
  [out] HANDLE                 hCookie;
  [out] VOID                   *pSurfData;
  [out] UINT                   Pitch;
  [out] UINT                   SlicePitch;
        D3DGPU_VIRTUAL_ADDRESS GpuVirtualAddress;
} D3DDDIARG_LOCKASYNC;

Angehörige

[in] hResource

Ein Handle für die zu sperrende Ressource.

[in] SubResourceIndex

Der nullbasierte Index in der Ressource, die hResource- angibt. Dieser Index gibt die zu sperrende Unterressource oder Oberfläche an.

[in] Flags

Eine D3DDDI_LOCKASYNCFLAGS Struktur, die in Bitfeldkennzeichnungen angibt, wie die Ressource gesperrt wird.

Hinweis Einige Flags schließen sich gegenseitig mit anderen Flags aus. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

[in] Range

Eine D3DDDIRANGE Struktur, die die Unterrange der zu sperrenden linearen Ressource beschreibt, wenn die RangeValid- Bitfeldkennzeichnung in der D3DDDI_LOCKASYNCFLAGS Struktur festgelegt ist, die Flags angibt.

[in] Area

Eine RECT- Struktur, die das Zusperrende der Oberfläche beschreibt, wenn das AreaValid- Bitfeld-Flag in der D3DDDI_LOCKASYNCFLAGS Struktur festgelegt ist, die Flags angibt.

[in] Box

Eine D3DDDIBOX Struktur, die das Untervolume des zu sperrenden Volumes beschreibt, wenn die BoxValid- Bitfeld-Flag in der D3DDDI_LOCKASYNCFLAGS Struktur festgelegt ist, die Flags angibt.

[out] hCookie

Ein Handle, das die umbenannte Ressource darstellt. Dieses Handle ist nur gültig, wenn das Verwerfen Bitfeldkennzeichnung in der D3DDDI_LOCKASYNCFLAGS Struktur festgelegt ist, die Flags angibt.

[out] pSurfData

Ein Zeiger auf den Speicherbereich für die Ressource, die gesperrt wurde. Die LockAsync- 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 LockAsync- Funktion des Benutzermodus zeigt diesen Neigungswert an die Direct3D-Laufzeit zurück.

[out] SlicePitch

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

GpuVirtualAddress

Dieses Element ist reserviert und sollte auf Null festgelegt werden.

Dieses Mitglied ist ab Windows 7 verfügbar.

Bemerkungen

Die Elemente der D3DDDI_LOCKASYNCFLAGS Struktur, die vom Flags Member angegeben werden, müssen die folgenden Regeln einhalten:

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.

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_LOCKASYNCFLAGS

LockAsync-

RECT-

Freigeben über