Méthode IWiaMiniDrv ::d rvGetWiaFormatInfo (wiamindr_lh.h)
La méthode IWiaMiniDrv ::d rvGetWiaFormatInfo recherche les formats d’image et les types de médias 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 dans le tableau pointé par ppwfi.
__MIDL__IWiaMiniDrv0062
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. Dans le cas contraire, un code d’erreur spécifique au minidriver sera stocké à l’emplacement indiqué par 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 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 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 pointée par plDevErrVal.
La valeur pointée par plDevErrVal peut être convertie en chaîne en appelant IWiaMiniDrv ::d rvGetDeviceErrorStr.
Remarques
Cette méthode crée un tableau de structures WIA_FORMAT_INFO qui décrivent les types multimédias et les formats d’image pris en charge par le périphérique 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_FILE ou TYMED_MULTIPAGE_FILE. Les valeurs typiques du format d’image incluent WiaImgFmt_JPEG et WiaImgFmt_BMP, entre autres. Pour plus d’informations, consultez Présentation de TYMED et WIA_IPA_FILENAME_EXTENSION.
Le minidriver peut définir un tableau global pour contenir les structures WIA_FORMAT_INFO , ou il peut allouer de la mémoire pour le tableau. Le service WIA ne libère pas la mémoire allouée. Le minidriver doit donc stocker un pointeur vers cette mémoire dans le contexte de l’élément de pilote. Le minidriver peut ensuite libérer cette mémoire dans un appel à IWiaMiniDrv ::d rvFreeDrvItemContext.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wiamindr_lh.h (inclure Wiamindr.h) |