Partager via


Méthode IWiaMiniDrv ::d rvLockWiaDevice (wiamindr_lh.h)

La méthode IWiaMiniDrv ::d rvLockWiaDevice verrouille le périphérique matériel WIA afin que seul le minidriver actuel puisse y accéder.

Syntaxe

HRESULT drvLockWiaDevice(
  BYTE *__MIDL__IWiaMiniDrv0030,
  LONG __MIDL__IWiaMiniDrv0031,
  LONG *__MIDL__IWiaMiniDrv0032
);

Paramètres

__MIDL__IWiaMiniDrv0030

lFlags [in]

Réservé.

__MIDL__IWiaMiniDrv0031

pWiasContext [in]

Pointeur vers un contexte d’élément WIA.

__MIDL__IWiaMiniDrv0032

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. Sinon, un code d’erreur spécifique au minidriver est 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 rvLockWiaDevice est utilisée pour verrouiller l’accès à l’appareil. Cette opération est généralement effectuée avant l’écriture des propriétés sur l’appareil ou avant un transfert de données. La méthode IWiaMiniDrv ::d rvLockWiaDevice doit être implémentée à l’aide de la méthode lock device de l’interface IStiDevice , IStiDevice ::LockDevice.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête wiamindr_lh.h (incluez Wiamindr.h)

Voir aussi

IWiaMiniDrv

IWiaMiniDrv ::d rvGetDeviceErrorStr

IWiaMiniDrv ::d rvUnLockWiaDevice