Méthode IWiaMiniDrv ::d rvFreeDrvItemContext (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 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 un 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
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 la mémoire qu’il a allouée au contexte. Par exemple, dans IWiaMiniDrv ::d rvReadItemProperties, un minidriver d’appareil photo 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 du pilote. Le minidriver libérerait alors le cache dans cette méthode.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wiamindr_lh.h (incluez Wiamindr.h) |