D3DDDIARG_LOCKASYNC-Struktur (d3dumddi.h)

  • Artikel

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;

Member

[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 Bitfeldflags 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 den Unterbereich der zu sperrenden linearen Ressource beschreibt, wenn das RangeValid-Bitfeldflag in der D3DDDI_LOCKASYNCFLAGS-Struktur festgelegt ist, die Flags angibt.

[in] Area

Eine RECT-Struktur , die das Subrectangle der zu sperrenden Oberfläche beschreibt, wenn das AreaValid-Bitfeldflag in der D3DDDI_LOCKASYNCFLAGS-Struktur festgelegt ist, die Flags angibt.

[in] Box

Eine D3DDDIBOX-Struktur, die das Untervolum des zu sperrenden Volumes beschreibt, wenn das BoxValid-Bitfeldflag 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 Flag Bitfeld verwerfen in der D3DDDI_LOCKASYNCFLAGS-Struktur festgelegt ist, die Flags angibt.

[out] pSurfData

Ein Zeiger auf den Speicherbereich für die gesperrte Ressource. Die LockAsync-Funktion des Benutzermodusanzeigetreibers gibt diesen Zeiger auf die Microsoft Direct3D-Runtime zurück.

[out] Pitch

Die Tonhöhe der gesperrten Oberfläche in Bytes. Die LockAsync-Funktion des Benutzermodusanzeigetreibers gibt diesen Pitchwert an die Direct3D-Runtime zurück.

[out] SlicePitch

Der Slice-Pitch in Bytes der gesperrten Oberfläche. Die LockAsync-Funktion des Benutzermodusanzeigetreibers gibt diesen Slice pitch-Wert an die Direct3D-Runtime zurück.

GpuVirtualAddress

Dieser Member ist reserviert und sollte auf 0 (null) festgelegt werden.

Dieses Mitglied ist ab Windows 7 verfügbar.

Hinweise

Die Member der D3DDDI_LOCKASYNCFLAGS-Struktur , die der Flags-Member angibt, müssen den folgenden Regeln entsprechen:

  • Das NoOverwrite-Bitfeldflag darf nicht gleichzeitig mit dem Flag Bitfeld verwerfen festgelegt werden.
  • Es muss jederzeit nur eines der Bitfeldflags RangeValid, AreaValid und BoxValid festgelegt werden.

Anforderungen

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

Weitere Informationen

D3DDDI_LOCKASYNCFLAGS

LockAsync

RECT