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 |