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 :

[in, out] pmdtc

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

Valeur retournée

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’image d’élément et d’en-tête d’élément. En outre, il peut éventuellement remplir un en-tête d’image si le format d’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 de l’en-tête dans le membre lHeaderSize 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 connue qu’après l’acquisition des données, comme avec les formats TIFF multipage et compressés, le membre lItemSize de la structure MINIDRV_TRANSFER_CONTEXT est signalé comme zéro. Le membre lImageSize est signalé comme la 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 remplie avec des informations dérivées des propriétés d’image de l’élément. Cet indicateur doit être utilisé lorsqu’un minidriver a alloué un nouveau contexte.

Configuration requise

Voir aussi

MINIDRV_TRANSFER_CONTEXT