Estrutura DEVICEDIALOGDATA (wiadevd.h)

Artigo
02/07/2025

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

Sintaxe

typedef struct tagDEVICEDIALOGDATA {
  DWORD    cbSize;
  HWND     hwndParent;
  IWiaItem *pIWiaItemRoot;
  DWORD    dwFlags;
  LONG     lIntent;
  LONG     lItemCount;
  IWiaItem **ppWiaItems;
} DEVICEDIALOGDATA, *LPDEVICEDIALOGDATA, *PDEVICEDIALOGDATA;

Membros

cbSize

Especifica o tamanho dessa estrutura em bytes.

hwndParent

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

pIWiaItemRoot

Aponta para uma interface IWiaItem que representa o item raiz válido na árvore de itens do aplicativo. Para obter mais informações sobre essa interface, consulte a documentação do SDK do Windows.

dwFlags

Especifica os sinalizadores passados para IWiaItem::D eviceDlg e IWiaDevMgr::GetImageDlg pelo programa de chamada. Esses métodos são descritos na documentação do SDK do Windows. Os valores possíveis para esse membro são WIA_DEVICE_DIALOG_SINGLE_IMAGE e WIA_DEVICE_DIALOG_USE_COMMON_UI (definidos em Wiadef.h).

lIntent

Especifica as intenções passadas para IWiaItem::D eviceDlg e IWiaDevMgr::GetImageDlg pelo programa de chamada (consulte a documentação do SDK do Windows).

lItemCount

Especifica o número de itens na matriz à qual ppIWiaItems pontos.

ppWiaItems

Matriz de ponteiros de interface IWiaItem. A matriz deve

Observações

A estrutura DEVICEDIALOGDATA é usada pelo método IWiaUIExtension::D eviceDialog.

A matriz especificada em ppIWiaItems deve ser alocada usando CoTaskMemAlloc. Todos os ponteiros de interface indicados na matriz devem ser inicializados usando o método COM AddRef. Consulte a documentação do SDK do Windows para obter descrições dessas funções.

A interface IWiaPropertyStorage é usada para acessar informações sobre as propriedades do objeto IWiaItem. Os aplicativos devem consultar um item para obter sua interface de IWiaPropertyStorage. Consulte a documentação do SDK do Windows para obter descrições dessa interface.

Requisitos

Requisito	Valor
cabeçalho	wiadevd.h (inclua Wiadevd.h)

Consulte também

IWiaUIExtension::D eviceDialog

Compartilhar via