Méthode IWiaMiniDrv ::d rvGetWiaFormatInfo (wiamindr_lh.h)
La méthode IWiaMiniDrv ::d rvGetWiaFormatInfo recherche les formats d’image et les types de supports pris en charge par l’appareil matériel WIA.
Syntaxe
HRESULT drvGetWiaFormatInfo(
BYTE *__MIDL__IWiaMiniDrv0059,
LONG __MIDL__IWiaMiniDrv0060,
LONG *__MIDL__IWiaMiniDrv0061,
WIA_FORMAT_INFO **__MIDL__IWiaMiniDrv0062,
LONG *__MIDL__IWiaMiniDrv0063
);
Paramètres
__MIDL__IWiaMiniDrv0059
lFlags [in]
Réservé.
__MIDL__IWiaMiniDrv0060
pWiasContext [in]
Pointeur vers un contexte d’élément WIA.
__MIDL__IWiaMiniDrv0061
pcelt [out]
Pointe vers un emplacement de mémoire qui recevra le nombre d’éléments du tableau pointé par ppwfi.
__MIDL__IWiaMiniDrv0062
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.
__MIDL__IWiaMiniDrv0063
ppwfi [out, facultatif]
Pointe vers un emplacement de mémoire qui recevra l’adresse du premier élément d’un tableau de structures WIA_FORMAT_INFO.
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 cette méthode est appelée pour les éléments qui ne contiennent aucune donnée, elle doit retourner E_INVALIDARG. 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.
Remarques
Cette méthode crée un tableau de structures WIA_FORMAT_INFO qui décrivent les types de supports et les formats d’image pris en charge par l’appareil matériel WIA. Pour chaque élément du tableau, le type de média peut être l’un des TYMED_CALLBACK, TYMED_MULTIPAGE_CALLBACK, TYMED_FILEou TYMED_MULTIPAGE_FILE. Les valeurs classiques pour le format d’image incluent WiaImgFmt_JPEG et WiaImgFmt_BMP, entre autres. Pour plus d’informations, consultez Understanding TYMED et WIA_IPA_FILENAME_EXTENSION.
Le minidriver peut définir un tableau global pour contenir les structures WIA_FORMAT_INFO, ou allouer de la mémoire pour le tableau. Le service WIA ne libère pas la mémoire allouée. Par conséquent, le minidriver doit stocker un pointeur vers cette mémoire dans le contexte de l’élément de pilote. Le minidriver peut alors libérer cette mémoire dans un appel à IWiaMiniDrv ::d rvFreeDrvItemContext.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wiamindr_lh.h (include Wiamindr.h) |