struktur DD_GETDRIVERINFODATA (ddrawint.h)

Artikel
03/09/2023

Struktur DD_GETDRIVERINFODATA digunakan untuk meneruskan data ke dan dari rutinitas panggilan balik DdGetDriverInfo .

Sintaks

typedef struct _DD_GETDRIVERINFODATA {
  VOID    *dhpdev;
  DWORD   dwSize;
  DWORD   dwFlags;
  GUID    guidInfo;
  DWORD   dwExpectedSize;
  PVOID   lpvData;
  DWORD   dwActualSize;
  HRESULT ddRVal;
} *PDD_GETDRIVERINFODATA, DD_GETDRIVERINFODATA;

Anggota

dhpdev

Tangani ke PDEV driver. Microsoft Windows 2000 dan yang lebih baru saja.

dwSize

Menentukan ukuran dalam byte struktur DD_GETDRIVERINFODATA ini.

dwFlags

Saat ini tidak digunakan dan diatur ke nol.

guidInfo

Menentukan GUID dukungan Microsoft DirectX tempat driver sedang dikueri. Dalam driver Microsoft DirectDraw Windows 2000 dan yang lebih baru, anggota ini bisa menjadi salah satu nilai berikut (dalam urutan alfabet):

GUID	Deskripsi
GUID_ColorControlCallbacks	Mengkueri apakah driver mendukung DdControlColor. Jika driver mendukungnya, driver harus menginisialisasi dan mengembalikan struktur DD_COLORCONTROLCALLBACKS dalam buffer tempat lpvData menunjuk.
GUID_D3DCallbacks	Kueri apakah driver mendukung salah satu fungsionalitas yang ditentukan melalui struktur D3DHAL_CALLBACKS . Jika driver tidak memberikan dukungan ini, driver harus menginisialisasi dan mengembalikan struktur D3DHAL_CALLBACKS dalam buffer tempat lpvData menunjuk.
GUID_D3DCallbacks2	Kedaluwarsa.
GUID_D3DCallbacks3	Mengkueri apakah driver mendukung salah satu fungsionalitas yang ditentukan melalui struktur D3DHAL_CALLBACKS3 . Jika driver memberikan salah satu dukungan ini, driver harus menginisialisasi dan mengembalikan struktur D3DHAL_CALLBACKS3 dalam buffer tempat lpvData menunjuk.
GUID_D3DCaps	Kedaluwarsa.
GUID_D3DExtendedCaps	Mengkueri apakah driver mendukung salah satu fungsionalitas Microsoft Direct3D yang ditentukan melalui struktur D3DHAL_D3DEXTENDEDCAPS . Jika driver memberikan salah satu dukungan ini, driver harus menginisialisasi dan mengembalikan struktur D3DHAL_D3DEXTENDEDCAPS dalam buffer tempat lpvData menunjuk.
GUID_D3DParseUnknownCommandCallback	Menyediakan bagian Direct3D driver dengan D3dParseUnknownCommandCallback runtime Direct3D. Panggilan balik D3dDrawPrimitives2 driver memanggil D3dParseUnknownCommandCallback untuk mengurai perintah dari buffer perintah yang tidak dipahami driver. DirectDraw meneruskan pointer ke fungsi ini di buffer tempat lpvData menunjuk. Jika driver mendukung aspek Direct3D ini, driver harus menyimpan pointer.
GUID_GetHeapAlignment	Mengkueri apakah driver mendukung persyaratan penyelarasan permukaan berdasarkan per tumpukan. Jika driver memberikan dukungan ini, driver harus menginisialisasi dan mengembalikan struktur DD_GETHEAPALIGNMENTDATA dalam buffer tempat lpvData menunjuk.
GUID_KernelCallbacks	Kueri apakah driver mendukung salah satu fungsionalitas yang ditentukan melalui struktur DD_KERNELCALLBACKS . Jika driver memberikan salah satu dukungan ini, driver harus menginisialisasi dan mengembalikan struktur DD_KERNELCALLBACKS dalam buffer tempat lpvData menunjuk.
GUID_KernelCaps	Mengkueri apakah driver mendukung salah satu kemampuan mode kernel yang ditentukan melalui struktur DDKERNELCAPS . Jika driver memberikan salah satu dukungan ini, driver harus menginisialisasi dan mengembalikan struktur DDKERNELCAPS dalam buffer tempat lpvData menunjuk.
GUID_MiscellaneousCallbacks	Kueri apakah driver mendukung DdGetAvailDriverMemory. Jika driver mendukungnya, driver harus menginisialisasi dan mengembalikan struktur DD_MISCELLANEOUSCALLBACKS dalam buffer tempat lpvData menunjuk.
GUID_Miscellaneous2Callbacks	Kueri apakah driver mendukung fungsi lain-lain tambahan yang ditentukan dalam struktur DD_MISCELLANEOUS2CALLBACKS . Jika driver mendukung salah satu dukungan ini, driver harus menginisialisasi dan mengembalikan struktur DD_MISCELLANEOUS2CALLBACKS dalam buffer tempat lpvData menunjuk.
GUID_MotionCompCallbacks	Kueri apakah driver mendukung fungsionalitas kompensasi gerakan yang ditentukan melalui struktur DD_MOTIONCOMPCALLBACKS . Jika driver memberikan salah satu dukungan ini, harus menginisialisasi dan mengembalikan struktur DD_MOTIONCOMPCALLBACKS dalam buffer tempat lpvData menunjuk.
GUID_NonLocalVidMemCaps	Kueri apakah driver mendukung salah satu kemampuan memori tampilan nonlokal yang ditentukan melalui struktur DD_NONLOCALVIDMEMCAPS . Jika driver memberikan salah satu dukungan ini, driver harus menginisialisasi dan mengembalikan struktur DD_NONLOCALVIDMEMCAPS dalam buffer tempat lpvData menunjuk.
GUID_NTCallbacks	Kueri apakah driver mendukung salah satu fungsionalitas yang ditentukan melalui struktur DD_NTCALLBACKS . Jika driver memberikan salah satu dukungan ini, driver harus menginisialisasi dan mengembalikan struktur DD_NTCALLBACKS dalam buffer tempat lpvData menunjuk.
GUID_NTPrivateDriverCaps	Kueri apakah driver mendukung teknik pembuatan permukaan gaya Windows 98/Me yang ditentukan melalui struktur DD_NTPRIVATEDRIVERCAPS . Jika driver memberikan salah satu dukungan ini, driver harus menginisialisasi dan mengembalikan struktur DD_NTPRIVATEDRIVERCAPS dalam buffer tempat lpvData menunjuk.
GUID_UpdateNonLocalHeap	Mengkueri apakah driver mendukung pengambilan alamat dasar setiap timbunan nonlokal secara bergantian. Jika driver memberikan dukungan ini, driver harus menginisialisasi dan mengembalikan struktur DD_UPDATENONLOCALHEAPDATA dalam buffer tempat lpvData menunjuk.
GUID_VideoPortCallbacks	Mengkueri apakah driver mendukung ekstensi port video (VPE). Jika driver mendukung VPE, driver harus menginisialisasi dan mengembalikan struktur DD_VIDEOPORTCALLBACKS dalam buffer tempat lpvData menunjuk.
GUID_VideoPortCaps	Kueri apakah driver mendukung salah satu kemampuan objek VPE yang ditentukan melalui struktur DDVIDEOPORTCAPS . Jika driver memberikan salah satu dukungan ini, driver harus menginisialisasi dan mengembalikan struktur DDVIDEOPORTCAPS dalam buffer tempat lpvData menunjuk.
GUID_ZPixelFormats	Mengkueri format piksel yang didukung oleh buffer kedalaman. Jika driver mendukung Direct3D, driver harus mengalokasikan dan menginisialisasi anggota yang sesuai dari struktur DDPIXELFORMAT untuk setiap format z-buffer yang didukung dan mengembalikannya dalam buffer tempat lpvData menunjuk.

dwExpectedSize

Menentukan jumlah byte data yang diharapkan DirectDraw untuk diteruskan kembali oleh driver dalam buffer tempat lpvData menunjuk.

lpvData

Menunjuk ke buffer yang dialokasikan DirectDraw tempat driver menyalin data yang diminta. Buffer ini biasanya berukuran dwExpectedSize byte. Driver tidak boleh menulis lebih dari dwExpectedSize byte data di dalamnya. Driver menentukan jumlah byte yang ditulisnya ke buffer ini di anggota dwActualSize .

dwActualSize

Menentukan lokasi di mana driver mengembalikan jumlah byte data yang ditulisnya di lpvData.

ddRVal

Menentukan lokasi di mana driver menulis nilai pengembalian dari panggilan balik DdGetDriverInfo . Kode pengembalian DD_OK menunjukkan keberhasilan. Untuk informasi selengkapnya, lihat Mengembalikan Nilai untuk DirectDraw.

Keterangan

Struktur data yang diteruskan ke driver untuk panggilan DdGetDriverInfo memiliki perbedaan kecil antara Windows 98/Me dan Windows 2000 dan yang lebih baru. Pada Windows 2000 dan yang lebih baru struktur data disebut DD_GETDRIVERINFODATA dan pada Windows 98/Me struktur data disebut DDHAL_GETDRIVERINFODATA. Kedua struktur data menyertakan bidang untuk informasi konteks spesifik driver. Pada Windows 2000 dan yang lebih baru, DD_GETDRIVERINFODATA menyertakan bidang dhpdev yang menyimpan DHPDEV driver yang dipanggil. Hanya pada Windows 98/Me, DDHAL_GETDRIVERINFODATA menyertakan bidang dwContext yang disalin untuk bidang dwReserved3 cadangan driver dari objek global DirectDraw.

Persyaratan

Persyaratan	Nilai
Header	ddrawint.h (termasuk Winddi.h)

Lihat juga

DdGetDriverInfo

Bagikan melalui