Método IWiaMiniDrv::d rvGetCapabilities (wiamindr_lh.h)
O método IWiaMiniDrv::d rvGetCapabilities retorna uma matriz de eventos e comandos compatíveis com um dispositivo.
Sintaxe
HRESULT drvGetCapabilities(
BYTE *__MIDL__IWiaMiniDrv0048,
LONG __MIDL__IWiaMiniDrv0049,
LONG *__MIDL__IWiaMiniDrv0050,
WIA_DEV_CAP_DRV **__MIDL__IWiaMiniDrv0051,
LONG *__MIDL__IWiaMiniDrv0052
);
Parâmetros
__MIDL__IWiaMiniDrv0048
lFlags [in]
Especifica se a matriz apontada por ppCapabilites consiste em comandos, eventos ou ambos. Esse parâmetro pode ser um dos sinalizadores a seguir ou de ambos combinados por um operador OR.
| Sinalizador | Descrição |
|---|---|
| WIA_DEVICE_COMMANDS | A matriz consiste em comandos de dispositivo. |
| WIA_DEVICE_EVENTS | A matriz consiste em eventos de dispositivo. |
__MIDL__IWiaMiniDrv0049
pWiasContext [in]
Ponteiro para um contexto de item WIA.
__MIDL__IWiaMiniDrv0050
pcelt [out]
Aponta para um local de memória que receberá o número de elementos na matriz apontada pelo parâmetro ppCapabilities .
__MIDL__IWiaMiniDrv0051
plDevErrVal [out]
Aponta para um local de memória que receberá um código status para esse método. Se esse método retornar S_OK, o valor armazenado será zero. Caso contrário, um código de erro específico do minidriver será armazenado no local apontado por esse parâmetro.
__MIDL__IWiaMiniDrv0052
ppCapabilities [out, opcional]
Aponta para um local de memória que receberá o endereço do primeiro elemento de uma matriz de estruturas WIA_DEV_CAP_DRV que contêm os GUIDs de eventos e comandos compatíveis com o dispositivo.
Retornar valor
Com êxito, o método deve retornar S_OK e limpar o valor de erro do dispositivo apontado por plDevErrVal. Se o método falhar, ele deverá retornar um código de erro COM padrão e colocar um valor de código de erro específico do minidriver na memória apontada por plDevErrVal.
O valor apontado por plDevErrVal pode ser convertido em uma cadeia de caracteres chamando IWiaMiniDrv::d rvGetDeviceErrorStr.
Comentários
O serviço WIA chama o método minidriver IWiaMiniDrv::d rvGetCapabilities para obter uma lista de recursos de comando de hardware e/ou eventos de dispositivo. Em resposta a essa chamada, um minidriver define ppCapabilities com o endereço de uma matriz de ponteiros para dados GUID. Cada GUID corresponde a uma notificação de evento ou a um comando de dispositivo compatível com o dispositivo de geração de imagens. Quando o parâmetro lFlags é definido como WIA_DEVICE_COMMANDS, a matriz de GUIDs contém comandos de dispositivo. Quando lFlags é definido como WIA_DEVICE_EVENTS, a matriz de GUIDs contém eventos. Se lFlags estiver definido como WIA_DEVICE_COMMANDS | WIA_DEVICE_EVENTS, a matriz de GUIDs contém eventos e comandos, listados nessa ordem.
O cabeçalho Wiadef.h lista vários comandos e eventos predefinidos.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | wiamindr_lh.h (inclua Wiamindr.h) |