Méthode IWiaMiniDrv ::d rvGetCapabilities (wiamindr_lh.h)
La méthode IWiaMiniDrv ::d rvGetCapabilities retourne un tableau d’événements et de commandes pris en charge par un appareil.
Syntaxe
HRESULT drvGetCapabilities(
BYTE *__MIDL__IWiaMiniDrv0048,
LONG __MIDL__IWiaMiniDrv0049,
LONG *__MIDL__IWiaMiniDrv0050,
WIA_DEV_CAP_DRV **__MIDL__IWiaMiniDrv0051,
LONG *__MIDL__IWiaMiniDrv0052
);
Paramètres
__MIDL__IWiaMiniDrv0048
lFlags [in]
Spécifie si le tableau pointé vers par ppCapabilites se compose de commandes ou d’événements, ou des deux. Ce paramètre peut être l’un des indicateurs suivants ou des deux combinés par un opérateur OR.
| Indicateur | Description |
|---|---|
| WIA_DEVICE_COMMANDS | Le tableau se compose de commandes d’appareil. |
| WIA_DEVICE_EVENTS | Le tableau se compose d’événements d’appareil. |
__MIDL__IWiaMiniDrv0049
pWiasContext [in]
Pointeur vers un contexte d’élément WIA.
__MIDL__IWiaMiniDrv0050
pcelt [out]
Pointe vers un emplacement de mémoire qui recevra le nombre d’éléments dans le tableau pointé vers le paramètre ppCapabilities .
__MIDL__IWiaMiniDrv0051
plDevErrVal [out]
Pointe vers un emplacement de mémoire qui recevra un code status pour cette méthode. Si cette méthode retourne S_OK, la valeur stockée est égale à zéro. Dans le cas contraire, un code d’erreur spécifique au minidriver sera stocké à l’emplacement indiqué par ce paramètre.
__MIDL__IWiaMiniDrv0052
ppCapabilities [out, facultatif]
Pointe vers un emplacement de mémoire qui recevra l’adresse du premier élément d’un tableau de structures WIA_DEV_CAP_DRV qui contiennent les GUID des événements et des commandes pris en charge par l’appareil.
Valeur retournée
En cas de réussite, la méthode doit retourner S_OK et effacer la valeur d’erreur de l’appareil pointée par plDevErrVal. Si la méthode échoue, elle doit retourner un code d’erreur COM standard et placer une valeur de code d’erreur spécifique au minidriver dans la mémoire pointée par plDevErrVal.
La valeur pointée par plDevErrVal peut être convertie en chaîne en appelant IWiaMiniDrv ::d rvGetDeviceErrorStr.
Remarques
Le service WIA appelle la méthode minidriver IWiaMiniDrv ::d rvGetCapabilities pour obtenir une liste des fonctionnalités de commande matérielle et/ou des événements d’appareil. En réponse à cet appel, un minidriver définit ppCapabilities avec l’adresse d’un tableau de pointeurs vers des données GUID. Chaque GUID correspond à une notification d’événement ou à une commande d’appareil prise en charge par l’appareil d’imagerie. Lorsque le paramètre lFlags est défini sur WIA_DEVICE_COMMANDS, le tableau de GUID contient des commandes d’appareil. Lorsque lFlags a la valeur WIA_DEVICE_EVENTS, le tableau de GUID contient des événements. Si lFlags est défini sur WIA_DEVICE_COMMANDS | WIA_DEVICE_EVENTS, le tableau de GUID contient à la fois des événements et des commandes, répertoriés dans cet ordre.
L’en-tête Wiadef.h répertorie plusieurs commandes et événements prédéfinis.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wiamindr_lh.h (inclure Wiamindr.h) |