estrutura WIA_DEV_CAP_DRV (wiamindr_lh.h)
A estrutura WIA_DEV_CAP_DRV é usada para enumerar os recursos do dispositivo. Uma funcionalidade de dispositivo é definida por um evento ou comando compatível com o dispositivo.
Sintaxe
typedef struct _WIA_DEV_CAP_DRV {
GUID *guid;
ULONG ulFlags;
LPOLESTR wszName;
LPOLESTR wszDescription;
LPOLESTR wszIcon;
} WIA_DEV_CAP_DRV, *PWIA_DEV_CAP_DRV;
Membros
guid
Aponta para um GUID que identifica a funcionalidade do dispositivo. Esse membro pode ser definido como qualquer um dos valores especificados para comandos de dispositivo WIA (WIA_CMD_comandos de XXX) ou identificadores de eventos WIA (identificadores de evento WIA_EVENT_XXX). Para obter mais informações, consulte comandos de dispositivo WIA.
O driver pode definir seu próprio GUID de funcionalidade que pode enviar para o dispositivo. No entanto, um aplicativo precisaria ter conhecimento específico sobre essa funcionalidade para que ele possa responder à nova funcionalidade. Normalmente, um aplicativo reconhece apenas os GUIDs de eventos e comando wia padrão (WIA_CMD_XXX e WIA_EVENT_XXX).
ulFlags
Especifica o tipo de evento. Esse membro pode ser definido como um ou ambos os seguintes:
| Bandeira | Significado |
|---|---|
| WIA_ACTION_EVENT | O aplicativo pode registrar a ação para o evento especificado usando os métodos IWiaDevMgr::RegisterEventCallbackProgram e IwiaDevMgr::RegisterEventCallbackCLSID. Um evento de ação inicia o aplicativo registrado para lidar com esse evento. |
| WIA_NOTIFICATION_EVENT | O aplicativo pode se registrar para notificação no evento especificado usando o método IwiaDevMgr::RegisterEventCallbackInterface método. Um evento de notificação é enviado somente para aplicativos que já estão em execução. |
wszName
Especifica uma cadeia de caracteres que contém uma versão curta do nome da funcionalidade.
wszDescription
Especifica uma cadeia de caracteres que contém a versão do nome da funcionalidade que pode ser exibida para o usuário.
wszIcon
Especifica uma cadeia de caracteres que contém o nome do ícone para essa funcionalidade. O ícone pode ser exibido para o usuário.
Observações
O serviço WIA chama a função IWiaMiniDrv::d rvGetCapabilities do minidriver para preencher os membros de uma estrutura de WIA_DEV_CAP_DRV.
Quando um driver está enumerando manipuladores de eventos, o único valor válido é WIA_IS_DEFAULT_HANDLER; que indica que o manipulador registrado no momento deve ser usado.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | wiamindr_lh.h (inclua Wiamindr.h) |