Partager via


wiasGetImageInformation, fonction (wiamdef.h)

La fonction wiasGetImageInformation récupère les informations de contexte de transfert à partir d’un élément.

Syntaxe

HRESULT wiasGetImageInformation(
  [in]      BYTE                      *pWiasContext,
            LONG                      lFlags,
  [in, out] PMINIDRV_TRANSFER_CONTEXT pmdtc
);

Paramètres

[in] pWiasContext

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

lFlags

Spécifie les indicateurs opérationnels. Actuellement, seul l’indicateur suivant est défini :

Drapeau Signification
WIAS_INIT_CONTEXT Initialisez la structure MINIDRV_TRANSFER_CONTEXT.

[in, out] pmdtc

Pointeur vers une structure MINIDRV_TRANSFER_CONTEXT. Lors du retour, cette structure contient les informations demandées sur l’élément d’image.

Valeur de retour

En cas de réussite, la fonction retourne S_OK.

Si la fonction échoue, elle retourne une erreur COM standard ou l’un des codes d’erreur WIA .

Remarques

Cette fonction utilise une structure MINIDRV_TRANSFER_CONTEXT pour calculer les tailles d’en-tête d’élément et d’image d’élément. En outre, il peut éventuellement remplir un en-tête d’image si le format de l’image nécessite un en-tête de données. L’en-tête est copié dans la mémoire tampon si le membre pTransferBuffer de la structure MINIDRV_TRANSFER_CONTEXT n’est pas NULL. Lorsque vous utilisez des formats d’image (tels que JPEG) qui n’ont pas d’en-tête, la taille d’en-tête dans la lHeaderSize membre de la structure MINIDRV_TRANSFER_CONTEXT est signalée comme zéro.

Pour les formats d’image où la taille finale réelle de l’image n’est pas connue tant qu’après l’acquisition de données, comme avec les formats TIFF multipage et compressés, le lItemSize membre de la structure MINIDRV_TRANSFER_CONTEXT est signalé comme zéro. Le membre lImageSize est signalé comme taille, en octets, de l’image non compressée dans une seule page.

Si WIAS_INIT_CONTEXT est spécifié dans le paramètre lFlags, la structure MINIDRV_TRANSFER_CONTEXT pointée par le paramètre pmdtc est renseignée avec des informations dérivées des propriétés de l’image de l’élément. Cet indicateur doit être utilisé lorsqu’un minidriver a alloué un nouveau contexte.

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête wiamdef.h (include Wiamdef.h)
bibliothèque Wiaservc.lib
DLL Wiaservc.dll

Voir aussi

MINIDRV_TRANSFER_CONTEXT