struktur DD_GETDRIVERINFODATA (ddrawint.h)
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) |