IWiaMiniDrv ::d rvFreeDrvItemContext, méthode (wiamindr_lh.h)
La méthode IWiaMiniDrv ::d rvFreeDrvItemContext libère un contexte spécifique à l’appareil.
Syntaxe
HRESULT drvFreeDrvItemContext(
LONG __MIDL__IWiaMiniDrv0056,
BYTE *__MIDL__IWiaMiniDrv0057,
LONG *__MIDL__IWiaMiniDrv0058
);
Paramètres
__MIDL__IWiaMiniDrv0056
lFlags [in]
Réservé.
__MIDL__IWiaMiniDrv0057
pSpecContext [in]
Pointe vers un contexte spécifique à l’appareil.
__MIDL__IWiaMiniDrv0058
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 un 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.
Remarques
Lorsqu’un élément de pilote est supprimé, le service WIA libère le contexte de l’élément de pilote. Cette méthode informe le minidriver que le contexte est prêt à être libéré. Le minidriver doit libérer toute mémoire allouée pour le contexte. Par exemple, dans IWiaMiniDrv ::d rvReadItemProperties, un minidriver de caméra peut allouer un cache pour stocker la miniature d’un élément et stocker un pointeur vers ce cache dans le contexte de l’élément de pilote. Le minidriver libérerait ensuite le cache dans cette méthode.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wiamindr_lh.h (include Wiamindr.h) |