Structure DVTARGETDEVICE (objidl.h)

Spécifie des informations sur l’appareil cible pour lequel les données sont composées. DVTARGETDEVICE contient suffisamment d’informations sur un appareil cible Windows pour qu’un handle dans un contexte d’appareil (HDC) puisse être créé à l’aide de la fonction CreateDC .

Syntaxe

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

Membres

tdSize

Taille, en octets, de la structure DVTARGETDEVICE . La taille initiale est incluse afin que la structure puisse être copiée plus facilement.

tdDriverNameOffset

Décalage, en octets, du début de la structure au nom du pilote de périphérique, qui est stocké sous la forme d’une chaîne terminée par NULL dans la mémoire tampon tdData .

tdDeviceNameOffset

Décalage, en octets, du début de la structure au nom de l’appareil, qui est stocké sous la forme d’une chaîne terminée par NULL dans la mémoire tampon tdData . Cette valeur peut être égale à zéro pour indiquer aucun nom d’appareil.

tdPortNameOffset

Décalage, en octets, du début de la structure au nom du port, qui est stocké sous forme de chaîne terminée par NULL dans la mémoire tampon tdData . Cette valeur peut être égale à zéro pour indiquer aucun nom de port.

tdExtDevmodeOffset

Décalage, en octets, du début de la structure à la structure DEVMODE récupérée en appelant DocumentProperties.

tdData[1]

Tableau d’octets contenant des données pour l’appareil cible. Il n’est pas nécessaire d’inclure des chaînes vides dans tdData (pour les noms dont la valeur de décalage est égale à zéro).

Notes

Certaines applications clientes OLE 1 construisent incorrectement des appareils cibles en allouant trop peu d’octets dans la structure DEVMODE pour DVTARGETDEVICE. Ils fournissent généralement uniquement le nombre d’octets dans le membre dmSize de DEVMODE. Le nombre d’octets à allouer doit être la somme de dmSize + dmDriverExtra. Lorsqu’un appel est effectué à la fonction CreateDC avec un périphérique cible incorrect, le pilote d’imprimante tente d’accéder aux octets supplémentaires et des résultats imprévisibles peuvent se produire. Pour vous protéger contre un incident et rendre les octets supplémentaires disponibles, OLE rembourse la taille des appareils cibles OLE 2 créés à partir d’appareils cibles OLE 1.

Spécifications

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
En-tête	objidl.h

Voir aussi

FORMATETC

IEnumFORMATETC

IViewObject

OleConvertOLESTREAMToIStorage