DVTARGETDEVICE-Struktur (objidl.h)

Gibt Informationen zum Zielgerät an, für das Daten zusammengestellt werden. DVTARGETDEVICE enthält genügend Informationen zu einem Windows-Zielgerät, damit ein Handle für einen Gerätekontext (HDC) mithilfe der CreateDC-Funktion erstellt werden kann.

Syntax

typedef struct tagDVTARGETDEVICE {
  DWORD tdSize;
  WORD  tdDriverNameOffset;
  WORD  tdDeviceNameOffset;
  WORD  tdPortNameOffset;
  WORD  tdExtDevmodeOffset;
  BYTE  tdData[1];
} DVTARGETDEVICE;

Members

tdSize

Die Größe der DVTARGETDEVICE-Struktur in Bytes. Die Anfangsgröße ist enthalten, sodass die Struktur einfacher kopiert werden kann.

tdDriverNameOffset

Der Offset in Bytes vom Anfang der Struktur bis zum Gerätetreibernamen, der als NULL-beendete Zeichenfolge im tdData-Puffer gespeichert wird.

tdDeviceNameOffset

Der Offset in Bytes vom Anfang der Struktur bis zum Gerätenamen, der als NULL-beendete Zeichenfolge im tdData-Puffer gespeichert wird. Dieser Wert kann null sein, um keinen Gerätenamen anzugeben.

tdPortNameOffset

Der Offset in Bytes vom Anfang der Struktur bis zum Portnamen, der als NULL-beendete Zeichenfolge im tdData-Puffer gespeichert wird. Dieser Wert kann null sein, um keinen Portnamen anzugeben.

tdExtDevmodeOffset

Der Offset in Bytes vom Anfang der Struktur bis zur DEVMODE-Struktur , die durch Aufrufen von DocumentProperties abgerufen wird.

tdData[1]

Ein Array von Bytes, das Daten für das Zielgerät enthält. Es ist nicht erforderlich, leere Zeichenfolgen in tdData einzuschließen (für Namen, bei denen der Offsetwert null ist).

Hinweise

Einige OLE 1-Clientanwendungen erstellen fälschlicherweise Zielgeräte, indem zu wenige Bytes in der DEVMODE-Struktur für das DVTARGETDEVICE zugewiesen werden. Sie geben in der Regel nur die Anzahl der Bytes im dmSize-Member von DEVMODE an. Die Anzahl der zuzuordnenden Bytes sollte die Summe von dmSize + dmDriverExtra sein. Wenn die CreateDC-Funktion mit einem falschen Zielgerät aufgerufen wird, versucht der Druckertreiber, auf die zusätzlichen Bytes zuzugreifen, und es können unvorhersehbare Ergebnisse auftreten. Um vor einem Absturz zu schützen und die zusätzlichen Bytes verfügbar zu machen, legt OLE die Größe der OLE 2-Zielgeräte fest, die von OLE 1-Zielgeräten erstellt wurden.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Kopfzeile	objidl.h

Weitere Informationen

FORMATETC

IEnumFORMATETC

IViewObject

OleConvertOLESTREAMToIStorage