estrutura DEVICEDIALOGDATA2 (wiadevd.h)

Artigo
08/08/2023

A estrutura DEVICEDIALOGDATA2 contém todos os dados necessários para implementar uma caixa de diálogo de dispositivo personalizada.

Sintaxe

typedef struct tagDEVICEDIALOGDATA2 {
  DWORD     cbSize;
  IWiaItem2 *pIWiaItemRoot;
  DWORD     dwFlags;
  HWND      hwndParent;
  BSTR      bstrFolderName;
  BSTR      bstrFilename;
  LONG      lNumFiles;
  BSTR      *pbstrFilePaths;
  IWiaItem2 *pWiaItem;
} DEVICEDIALOGDATA2, *LPDEVICEDIALOGDATA2, *PDEVICEDIALOGDATA2;

Membros

cbSize

Especifica o tamanho, em bytes, dessa estrutura.

pIWiaItemRoot

Aponta para uma interface IWiaItem2 que representa o item raiz válido na árvore de itens do aplicativo.

dwFlags

Especifica os sinalizadores passados para IWiaItem2::D eviceDlg e IWiaDevMgr2::GetImageDlg pelo programa de chamada. Os valores possíveis para esse membro são WIA_DEVICE_DIALOG_SINGLE_IMAGE e WIA_DEVICE_DIALOG_USE_COMMON_UI (definidos no arquivo de cabeçalho Wiadef.h).

hwndParent

Especifica o identificador para a janela pai da caixa de diálogo.

bstrFolderName

Uma cadeia de caracteres do tipo BSTR que contém o nome da pasta de destino para a qual os arquivos obtidos de itens WIA são transferidos.

bstrFilename

Uma cadeia de caracteres do tipo BSTR que contém o modelo de nome de arquivo a ser usado para arquivos transferidos de itens WIA para a pasta de destino designada por bstrFolderName. Um número arbitrário de nomes de arquivo exclusivos pode ser criado acrescentando caracteres adicionais ao modelo de nome de arquivo. Para obter mais informações sobre modelos de nome de arquivo, consulte PathMakeUniqueName e PathYetAnotherMakeUniqueName.

lNumFiles

O número de cadeias de caracteres gravadas na matriz pbstrFilePaths .

pbstrFilePaths

Ponteiro para uma matriz de ponteiros BSTR . Cada elemento de matriz aponta para um BSTR que contém o nome de destino de um arquivo que foi transferido com êxito para a pasta identificada por bstrFolderName. O método deve alocar o armazenamento para esse membro. Para obter mais informações, consulte a seção Comentários a seguir.

pWiaItem

Ponteiro para a interface IWiaItem2 do item WIA que transfere dados para o arquivo ou arquivos nomeados na matriz bstrFilePaths .

Comentários

A estrutura DEVICEDIALOGDATA2 é usada pelo método IWiaUIExtension2::D eviceDialog .

O método DeviceDialog deve alocar a matriz de ponteiros BSTR especificada em pbstrFilePaths chamando a função CoTaskMemAlloc e deve alocar cada cadeia de caracteres apontada pela matriz chamando a função SysAllocString . O programa de chamada é responsável por liberar o armazenamento para a matriz de ponteiro e cadeias de caracteres.

Para manter uma referência a uma interface IWiaItem2 , o método DeviceDialog deve chamar o método IUnknown::AddRef na interface antes de retornar da chamada.

Para acessar informações sobre as propriedades de um objeto IWiaItem2 , o método DeviceDialog deve consultar o objeto para obter sua interface IWiaPropertyStorage . Para transferir dados de um objeto IWiaItem2 , o método DeviceDialog deve consultar o objeto para obter sua interface IWiaTransfer .