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

Article
02/07/2025

La méthode IWiaMiniDrv ::d rvValidateItemProperties valide les propriétés d’un élément par rapport à l’ensemble de valeurs valides pour chaque propriété et met à jour ces propriétés si nécessaire.

Syntaxe

HRESULT drvValidateItemProperties(
  BYTE           *__MIDL__IWiaMiniDrv0016,
  LONG           __MIDL__IWiaMiniDrv0017,
  ULONG          __MIDL__IWiaMiniDrv0018,
  const PROPSPEC *__MIDL__IWiaMiniDrv0019,
  LONG           *__MIDL__IWiaMiniDrv0020
);

Paramètres

__MIDL__IWiaMiniDrv0016

lFlags [in]

Réservé. Défini sur zéro.

__MIDL__IWiaMiniDrv0017

nPropSpec [in]

Indique le nombre d’éléments dans le tableau pPropSpec.

__MIDL__IWiaMiniDrv0018

pPropSpec [in]

Pointe vers le premier élément d’un tableau de structures PROPSPEC.

__MIDL__IWiaMiniDrv0019

pWiasContext [in]

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

__MIDL__IWiaMiniDrv0020

plDevErrVal [out]

Pointe vers un emplacement de mémoire qui recevra un code d’état 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 vers lequel pointe ce paramètre.

Valeur de retour

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 vers laquelle pointe plDevErrVal.

La valeur pointée par plDevErrVal peut être convertie en chaîne en appelant IWiaMiniDrv ::d rv ::d rvGetDeviceErrorStr.