Compartilhar via


estrutura WIA_DEV_CAP (wia_xp.h)

Os aplicativos usam a estrutura WIA_DEV_CAP para enumerar as funcionalidades do dispositivo. Uma funcionalidade de dispositivo é definida por um evento ou comando compatível com o dispositivo. Para obter mais informações, consulte IEnumWIA_DEV_CAPS.

Sintaxe

typedef struct _WIA_DEV_CAP {
  GUID  guid;
  ULONG ulFlags;
  BSTR  bstrName;
  BSTR  bstrDescription;
  BSTR  bstrIcon;
  BSTR  bstrCommandline;
} WIA_DEV_CAP, *PWIA_DEV_CAP, WIA_EVENT_HANDLER, *PWIA_EVENT_HANDLER;

Membros

guid

Tipo: GUID

Especifica um GUID que identifica a funcionalidade do dispositivo. Esse membro pode ser definido como qualquer um dos valores especificados em Comandos de Dispositivo WIA ou Identificadores de Eventos WIA.

ulFlags

Tipo: ULONG

Usado ao enumerar manipuladores de eventos. Os valores possíveis são listados nesta tabela.

Valor Descrição
WIA_IS_DEFAULT_HANDLER O manipulador registrado no momento deve ser usado. Esse é o único valor válido ao enumerar manipuladores de eventos. Ele não é um valor válido ao enumerar recursos de evento de um dispositivo.
WIA_ACTION_EVENT O evento é do tipo de ação, portanto, os programas que usam APIs de registro persistente, IWiaDevMgr::RegisterEventCallbackProgram e IWiaDevMgr::RegisterEventCallbackCLSID, podem recebê-lo.
WIA_NOTIFICATION_EVENT O evento é do tipo de notificação, portanto, os programas que usam a função de registro de runtime, IWiaDevMgr::RegisterEventCallbackInterface, podem recebê-lo.

bstrName

Tipo: BSTR

Especifica uma cadeia de caracteres que contém uma versão curta do nome da funcionalidade.

bstrDescription

Tipo: BSTR

Especifica uma cadeia de caracteres que contém uma descrição da funcionalidade que é exibida para o usuário.

bstrIcon

Tipo: BSTR

Especifica uma cadeia de caracteres que representa o local e a ID do recurso do ícone que representa essa funcionalidade ou manipulador. A cadeia de caracteres deve ser do seguinte formato: drive:\path\module,n, em que n é a ID de recurso negada do ícone (ou seja, se a ID do recurso do ícone for 100, n será -100).

bstrCommandline

Tipo: BSTR

Especifica uma cadeia de caracteres que representa argumentos de linha de comando.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho wia_xp.h (inclua Wia.h)