Struktur DVTARGETDEVICE (objidl.h)

  • Artikel

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

Lihat juga

FORMATETC

IEnumFORMATETC

IViewObject

OleConvertOLESTREAMToIStorage