Struktur DVTARGETDEVICE (objidl.h)
Menentukan informasi tentang perangkat target tempat data sedang dibuat. DVTARGETDEVICE berisi informasi yang cukup tentang perangkat target Windows sehingga handel ke konteks perangkat (HDC) dapat dibuat menggunakan fungsi CreateDC .
Sintaks
typedef struct tagDVTARGETDEVICE {
DWORD tdSize;
WORD tdDriverNameOffset;
WORD tdDeviceNameOffset;
WORD tdPortNameOffset;
WORD tdExtDevmodeOffset;
BYTE tdData[1];
} DVTARGETDEVICE;
Anggota
tdSize
Ukuran, dalam byte, dari struktur DVTARGETDEVICE . Ukuran awal disertakan sehingga struktur dapat disalin dengan lebih mudah.
tdDriverNameOffset
Offset, dalam byte, dari awal struktur hingga nama driver perangkat, yang disimpan sebagai string yang dihentikan NULL di buffer tdData .
tdDeviceNameOffset
Offset, dalam byte, dari awal struktur hingga nama perangkat, yang disimpan sebagai string yang dihentikan NULL di buffer tdData . Nilai ini bisa nol untuk menunjukkan tidak ada nama perangkat.
tdPortNameOffset
Offset, dalam byte, dari awal struktur hingga nama port, yang disimpan sebagai string yang dihentikan NULL di buffer tdData . Nilai ini bisa nol untuk menunjukkan tidak ada nama port.
tdExtDevmodeOffset
Offset, dalam byte, dari awal struktur ke struktur DEVMODE yang diambil dengan memanggil DocumentProperties.
tdData[1]
Array byte yang berisi data untuk perangkat target. Tidak perlu menyertakan string kosong dalam tdData (untuk nama di mana nilai offset adalah nol).
Keterangan
Beberapa aplikasi klien OLE 1 salah membuat perangkat target dengan mengalokasikan terlalu sedikit byte dalam struktur DEVMODE untuk DVTARGETDEVICE. Mereka biasanya hanya menyediakan jumlah byte di anggota dmSizeDEVMODE. Jumlah byte yang akan dialokasikan harus berupa jumlah dmSize + dmDriverExtra. Ketika panggilan dilakukan ke fungsi CreateDC dengan perangkat target yang salah, driver printer mencoba mengakses byte tambahan dan hasil yang tidak dapat diprediksi dapat terjadi. Untuk membantu melindungi dari crash dan membuat byte tambahan tersedia, OLE menyediakan ukuran perangkat target OLE 2 yang dibuat dari perangkat target OLE 1.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung | Windows 2000 Server [aplikasi desktop | Aplikasi UWP] |
| Header | objidl.h |