struktur D3DDDIARG_LOCK (d3dumddi.h)

Artikel
02/23/2024

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

Sintaks

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;

Anggota

[in] hResource

Handel ke sumber daya yang akan dikunci.

[in] SubResourceIndex

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

[in] Range

Struktur D3DDDIRANGE yang menjelaskan subrange sumber daya linier untuk dikunci.

[in] Area

Struktur RECT yang menjelaskan subrektangle permukaan untuk dikunci.

[in] Box

Struktur D3DDDIBOX yang menjelaskan subvolume volume yang akan dikunci.

[out] pSurfData

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

[out] Pitch

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

[out] SlicePitch

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

[in] Flags

Struktur D3DDDI_LOCKFLAGS yang menunjukkan, dalam bendera bit-field, cara mengunci sumber daya. Perhatikan bahwa beberapa bendera saling eksklusif dengan bendera lain. Untuk informasi selengkapnya, lihat bagian Keterangan berikut ini.

Keterangan

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

Bendera bit-field ReadOnly dan WriteOnly tidak boleh diatur secara bersamaan.
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.
Bendera bit-field ReadOnly tidak boleh diatur secara bersamaan dengan bendera Buang bit-field.

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_LOCKFLAGS

Lock

Bagikan melalui