Méthode IWiaMiniDrv ::d rvUnLockWiaDevice (wiamindr_lh.h)
La méthode IWiaMiniDrv ::d rvUnLockWiaDevice déverrouille le périphérique matériel WIA afin que n’importe quel minidriver puisse y accéder.
Syntaxe
HRESULT drvUnLockWiaDevice(
BYTE *__MIDL__IWiaMiniDrv0033,
LONG __MIDL__IWiaMiniDrv0034,
LONG *__MIDL__IWiaMiniDrv0035
);
Paramètres
__MIDL__IWiaMiniDrv0033
lFlags [in]
Réservé.
__MIDL__IWiaMiniDrv0034
pWiasContext [in]
Pointeur vers un contexte d’élément WIA.
__MIDL__IWiaMiniDrv0035
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.
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
La méthode IWiaMiniDrv ::d rvUnLockWiaDevice est utilisée pour autoriser l’accès à l’appareil une fois que le verrouillage n’est plus nécessaire. Il est généralement appelé par le service WIA après l’écriture des propriétés sur l’appareil ou après un transfert de données.
L’implémentation du minidriver de la méthode IWiaMiniDrv ::d rvUnLockWiaDevice doit utiliser la méthode d’appareil de déverrouillage STI IStiDevice ::UnLockDevice.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wiamindr_lh.h (inclure Wiamindr.h) |