struktur D3DDDIARG_LOCKASYNC (d3dumddi.h)

Artikel
03/08/2023

Struktur D3DDDIARG_LOCKASYNC menjelaskan sumber daya atau permukaan dalam sumber daya untuk dikunci.

Sintaks

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;

Anggota

[in] hResource

Handel ke sumber daya yang akan dikunci.

[in] SubResourceIndex

Indeks berbasis nol ke dalam sumber daya yang ditentukan hResource . Indeks ini menunjukkan subsumber daya atau permukaan yang akan dikunci.

[in] Flags

Struktur D3DDDI_LOCKASYNCFLAGS yang menunjukkan, dalam bendera bit-field, cara mengunci sumber daya.

Catatan Beberapa bendera saling eksklusif dengan bendera lain. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

[in] Range

Struktur D3DDDIRANGE yang menjelaskan subrange sumber daya linier untuk dikunci, jika bendera bidang bit RangeValid diatur dalam struktur D3DDDI_LOCKASYNCFLAGS yang ditentukan Bendera .

[in] Area

Struktur RECT yang menjelaskan subrektangle permukaan untuk dikunci, jika bendera bidang bit AreaValid diatur dalam struktur D3DDDI_LOCKASYNCFLAGS yang ditentukan Bendera .

[in] Box

Struktur D3DDDIBOX yang menjelaskan subvolume volume yang akan dikunci, jika bendera bidang bit BoxValid diatur dalam struktur D3DDDI_LOCKASYNCFLAGS yang ditentukan Bendera .

[out] hCookie

Handel yang mewakili sumber daya yang diganti namanya. Handel ini valid hanya jika bendera Buang bidang bit diatur dalam struktur D3DDDI_LOCKASYNCFLAGS yang ditentukan Bendera .

[out] pSurfData

Penunjuk ke wilayah memori untuk sumber daya yang dikunci. Fungsi LockAsync driver tampilan mode pengguna mengembalikan penunjuk ini ke runtime Microsoft Direct3D.

[out] Pitch

Pitch, dalam byte, dari permukaan yang terkunci. Fungsi LockAsync driver tampilan mode pengguna mengembalikan nilai pitch ini ke runtime Direct3D.

[out] SlicePitch

Pitch ilis, dalam byte, dari permukaan yang terkunci. Fungsi LockAsync driver tampilan mode pengguna mengembalikan nilai pitch ilis ini ke runtime Direct3D.

GpuVirtualAddress

Anggota ini dicadangkan dan harus diatur ke nol.

Anggota ini tersedia dimulai dengan Windows 7.

Keterangan

Anggota struktur D3DDDI_LOCKASYNCFLAGS yang ditentukan anggota Bendera harus mematuhi aturan berikut:

Bendera bit-field NoOverwrite tidak boleh diatur secara bersamaan dengan bendera Buang bit-field.
Hanya salah satu bendera bidang bit RangeValid, AreaValid, dan BoxValid yang harus diatur kapan saja.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi yang lebih baru dari sistem operasi Windows.
Header	d3dumddi.h (termasuk D3dumddi.h)

Lihat juga

D3DDDI_LOCKASYNCFLAGS

LockAsync

RECT

Bagikan melalui