Estrutura DVTARGETDEVICE (objidl.h)

Especifica informações sobre o dispositivo de destino para o qual os dados estão sendo compostos. DVTARGETDEVICE contém informações suficientes sobre um dispositivo de destino do Windows para que um identificador para um contexto de dispositivo (HDC) possa ser criado usando a função CreateDC .

Sintaxe

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

Membros

tdSize

O tamanho, em bytes, da estrutura DVTARGETDEVICE . O tamanho inicial é incluído para que a estrutura possa ser copiada com mais facilidade.

tdDriverNameOffset

O deslocamento, em bytes, desde o início da estrutura até o nome do driver do dispositivo, que é armazenado como uma cadeia de caracteres terminada em NULL no buffer tdData .

tdDeviceNameOffset

O deslocamento, em bytes, desde o início da estrutura até o nome do dispositivo, que é armazenado como uma cadeia de caracteres terminada em NULL no buffer tdData . Esse valor pode ser zero para indicar nenhum nome de dispositivo.

tdPortNameOffset

O deslocamento, em bytes, desde o início da estrutura até o nome da porta, que é armazenado como uma cadeia de caracteres terminada em NULL no buffer tdData . Esse valor pode ser zero para indicar nenhum nome de porta.

tdExtDevmodeOffset

O deslocamento, em bytes, desde o início da estrutura até a estrutura DEVMODE recuperada chamando DocumentProperties.

tdData[1]

Uma matriz de bytes que contém dados para o dispositivo de destino. Não é necessário incluir cadeias de caracteres vazias em tdData (para nomes em que o valor de deslocamento é zero).

Comentários

Alguns aplicativos cliente OLE 1 constroem incorretamente dispositivos de destino alocando poucos bytes na estrutura DEVMODE para o DVTARGETDEVICE. Normalmente, eles fornecem apenas o número de bytes no membro dmSize de DEVMODE. O número de bytes a serem alocados deve ser a soma de dmSize + dmDriverExtra. Quando uma chamada é feita para a função CreateDC com um dispositivo de destino incorreto, o driver de impressora tenta acessar os bytes adicionais e resultados imprevisíveis podem ocorrer. Para ajudar a proteger contra uma falha e disponibilizar os bytes adicionais, o OLE preenche o tamanho dos dispositivos de destino OLE 2 criados a partir de dispositivos de destino OLE 1.

Requisitos

Confira também

FORMATETC

Ienumformatetc

Iviewobject

OleConvertOLESTREAMToIStorage