estrutura WIA_DEV_CAP_DRV (wiamindr_lh.h)
A estrutura WIA_DEV_CAP_DRV é usada para enumerar as funcionalidades 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 (comandos WIA_CMD_XXX ) ou identificadores de evento 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 poder responder à nova funcionalidade. Um aplicativo normalmente reconhece apenas os GUIDs de comando e evento 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:
Sinalizador | Significado |
---|---|
WIA_ACTION_EVENT | O aplicativo pode registrar a ação para o evento determinado usando os métodos IWiaDevMgr::RegisterEventCallbackProgram e IwiaDevMgr::RegisterEventCallbackCLSID . Um evento de ação inicia o aplicativo registrado para manipular esse evento. |
WIA_NOTIFICATION_EVENT | O aplicativo pode se registrar para notificação no evento determinado usando o método IwiaDevMgr::RegisterEventCallbackInterface . 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 .
Comentários
O serviço WIA chama a função IWiaMiniDrv::d rvGetCapabilities do minidriver para preencher os membros de uma estrutura 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) |