Método IWiaMiniDrv::d rvGetCapabilities (wiamindr_lh.h)
El método IWiaMiniDrv::d rvGetCapabilities devuelve una matriz de eventos y comandos que admite un dispositivo.
Sintaxis
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 si la matriz a la que apunta ppCapabilites consta de comandos, eventos o ambos. Este parámetro puede ser cualquiera de las marcas siguientes o de ambas combinadas por un operador OR.
| Marca | Descripción |
|---|---|
| WIA_DEVICE_COMMANDS | La matriz consta de comandos de dispositivo. |
| WIA_DEVICE_EVENTS | La matriz consta de eventos de dispositivo. |
__MIDL__IWiaMiniDrv0049
pWiasContext [in]
Puntero a un contexto de elemento WIA.
__MIDL__IWiaMiniDrv0050
pcelt [out]
Apunta a una ubicación de memoria que recibirá el número de elementos de la matriz a los que apunta el parámetro ppCapabilities .
__MIDL__IWiaMiniDrv0051
plDevErrVal [out]
Apunta a una ubicación de memoria que recibirá un código de estado para este método. Si este método devuelve S_OK, el valor almacenado será cero. De lo contrario, este parámetro almacenará un código de error específico del minidriver en la ubicación a la que apunta este parámetro.
__MIDL__IWiaMiniDrv0052
ppCapabilities [out, optional]
Apunta a una ubicación de memoria que recibirá la dirección del primer elemento de una matriz de estructuras de WIA_DEV_CAP_DRV que contienen los GUID de eventos y comandos que admite el dispositivo.
Valor devuelto
Si se ejecuta correctamente, el método debe devolver S_OK y borrar el valor de error del dispositivo al que apunta plDevErrVal. Si se produce un error en el método, debe devolver un código de error COM estándar y colocar un valor de código de error específico del minidriver en la memoria a la que apunta plDevErrVal.
El valor al que apunta plDevErrVal se puede convertir en una cadena llamando a IWiaMiniDrv::d rvGetDeviceErrorStr.
Comentarios
El servicio WIA llama al método de minidriver IWiaMiniDrv::d rvGetCapabilities para obtener una lista de funcionalidades de comandos de hardware o eventos de dispositivo. En respuesta a esta llamada, un minidriver establece ppCapabilities con la dirección de una matriz de punteros a datos GUID. Cada GUID corresponde a una notificación de eventos o a un comando de dispositivo compatible con el dispositivo de creación de imágenes. Cuando el parámetro lFlags se establece en WIA_DEVICE_COMMANDS, la matriz de GUID contiene comandos de dispositivo. Cuando lFlags se establece en WIA_DEVICE_EVENTS, la matriz de GUID contiene eventos. Si lFlags está establecido en WIA_DEVICE_COMMANDS | WIA_DEVICE_EVENTS, la matriz de GUID contiene eventos y comandos, enumerados en ese orden.
El encabezado Wiadef.h enumera varios comandos y eventos predefinidos.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | wiamindr_lh.h (incluya Wiamindr.h) |