Estructura DVTARGETDEVICE (objidl.h)

Especifica información sobre el dispositivo de destino para el que se componen los datos. DVTARGETDEVICE contiene suficiente información sobre un dispositivo de destino de Windows, por lo que se puede crear un identificador para un contexto de dispositivo (HDC) mediante la función CreateDC .

Sintaxis

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

Members

tdSize

Tamaño, en bytes, de la estructura DVTARGETDEVICE . El tamaño inicial se incluye para que la estructura se pueda copiar más fácilmente.

tdDriverNameOffset

Desplazamiento, en bytes, desde el principio de la estructura hasta el nombre del controlador de dispositivo, que se almacena como una cadena terminada en NULL en el búfer tdData .

tdDeviceNameOffset

Desplazamiento, en bytes, desde el principio de la estructura hasta el nombre del dispositivo, que se almacena como una cadena terminada en NULL en el búfer tdData . Este valor puede ser cero para indicar ningún nombre de dispositivo.

tdPortNameOffset

Desplazamiento, en bytes, desde el principio de la estructura hasta el nombre del puerto, que se almacena como una cadena terminada en NULL en el búfer tdData . Este valor puede ser cero para indicar ningún nombre de puerto.

tdExtDevmodeOffset

Desplazamiento, en bytes, desde el principio de la estructura hasta la estructura DEVMODE recuperada mediante una llamada a DocumentProperties.

tdData[1]

Matriz de bytes que contiene datos para el dispositivo de destino. No es necesario incluir cadenas vacías en tdData (para los nombres en los que el valor de desplazamiento es cero).

Comentarios

Algunas aplicaciones cliente OLE 1 construyen incorrectamente los dispositivos de destino asignando demasiados bytes en la estructura DEVMODE para DVTARGETDEVICE. Normalmente, solo proporcionan el número de bytes en el miembro dmSize de DEVMODE. El número de bytes que se asignará debe ser la suma de dmSize + dmDriverExtra. Cuando se realiza una llamada a la función CreateDC con un dispositivo de destino incorrecto, el controlador de impresora intenta acceder a los bytes adicionales y se pueden producir resultados imprevisibles. Para ayudar a protegerse contra un bloqueo y hacer que los bytes adicionales estén disponibles, OLE rellena el tamaño de los dispositivos de destino OLE 2 creados a partir de dispositivos de destino OLE 1.

Requisitos

Consulte también

FORMATETC

IEnumFORMATETC

IViewObject

OleConvertOLESTREAMToIStorage