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 |