struktur DD_GETDRIVERSTATEDATA (ddrawint.h)

Artikel
08/23/2023

Struktur DD_GETDRIVERSTATEDATA menjelaskan status driver.

Sintaks

typedef struct _DD_GETDRIVERSTATEDATA {
  DWORD   dwFlags;
  union {
    PDD_DIRECTDRAW_GLOBAL lpDD;
    DWORD_PTR             dwhContext;
  };
  LPDWORD lpdwStates;
  DWORD   dwLength;
  HRESULT ddRVal;
} *PDD_GETDRIVERSTATEDATA, DD_GETDRIVERSTATEDATA;

Anggota

dwFlags

Menentukan kumpulan bendera untuk menunjukkan data yang diminta. Parameter ini dapat diatur ke salah satu bendera berikut:

Bendera	Makna
D3DDEVINFOID_D3DTEXTUREMANAGER	Meminta informasi manajemen tekstur yang dilakukan oleh runtime Direct3D dalam struktur D3DDEVINFO_TEXTUREMANAGER.
D3DDEVINFOID_TEXTUREMANAGER	Meminta informasi manajemen tekstur yang dilakukan oleh driver atau runtime Direct3D dalam struktur D3DDEVINFO_TEXTUREMANAGER.
D3DDEVINFOID_TEXTURING	Meminta informasi aktivitas tekstur aplikasi dalam struktur D3DDEVINFO_TEXTURING.
D3DDEVINFOID_VCACHE	Hanya versi DirectX 8.1 Meminta informasi vertex-cache dalam struktur D3DDEVINFO_VCACHE.

lpDD

Menunjuk ke struktur DD_DIRECTDRAW_GLOBAL yang menjelaskan perangkat.

dwhContext

Menentukan ID konteks yang diminta informasi.

lpdwStates

Arahkan ke data status driver Direct3D yang akan diisi oleh driver. Jika, misalnya, D3DDEVINFOID_VCACHE ditentukan dalam anggota dwFlags , driver menunjuk anggota lpdwStates ke struktur D3DDEVINFO_VCACHE yang berisi informasi vertex-cache.

dwLength

Menentukan panjang, dalam byte, dari data status yang akan diisi oleh driver.

ddRVal

Menentukan lokasi tempat driver menulis nilai pengembalian panggilan balik D3dGetDriverState . Kode pengembalian D3D_OK menunjukkan keberhasilan. Untuk informasi selengkapnya, lihat Mengembalikan Kode untuk Panggilan Balik Driver Direct3D.

Keterangan

Aplikasi dapat menggunakan metode IDirect3DDevice7::GetInfo dan menentukan bendera D3DDEVINFOID_D3DTEXTUREMANAGER, D3DDEVINFOID_TEXTUREMANAGER, dan D3DDEVINFOID_TEXTURING untuk mengambil informasi teksur. Untuk informasi selengkapnya tentang metode ini dan struktur yang terkait dengan bendera ini, lihat dokumentasi DirectX SDK. Runtime kemudian meneruskan bendera ini ke driver.

Hanya versi DirectX 8.1.Runtime Direct3D menentukan bendera D3DDEVINFOID_VCACHE di anggota dwFlags untuk mengambil informasi vertex-cache dari driver yang ditentukan pada anggota lpDD . Driver menentukan informasi ini dalam struktur D3DDEVINFO_VCACHE dan mengembalikannya ke anggota lpdwStates .

DirectX 9.0 dan versi yang lebih baru saja. Runtime Direct3D secara asinkron meminta driver untuk informasi vertex-cache dengan menggunakan perintah D3DDP2OP_CREATEQUERY dan D3DDP2OP_ISSUEQUERY dan jenis kueri D3DQUERYTYPE_VCACHE dalam panggilan ke panggilan balik D3dDrawPrimitives2 driver. Untuk informasi selengkapnya, lihat D3DDEVINFO_VCACHE.

Catatan Bendera D3DDEVINFOID_VCACHE ditentukan dalam d3dhal.h; bendera lain yang dapat diatur dalam dwFlags ditentukan dalam d3dtypes.h.