wiasReadPropBin, fonction (wiamdef.h)

Article
03/01/2024

La fonction wiasReadPropBin récupère une valeur de propriété de données binaires à partir d’un élément WIA.

Syntaxe

HRESULT wiasReadPropBin(
  [in]            BYTE   *pWiasContext,
                  PROPID propid,
  [out]           BYTE   **ppbVal,
  [out, optional] BYTE   **ppbValOld,
                  BOOL   bMustExist
);

Paramètres

[in] pWiasContext

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

propid

Spécifie l’identificateur de propriété.

[out] ppbVal

Pointeur vers un emplacement de mémoire qui reçoit l’adresse d’une mémoire tampon allouée par cette fonction. Lors du retour, la mémoire tampon contient les données binaires de la propriété.

[out, optional] ppbValOld

Pointeur vers un emplacement de mémoire qui reçoit l’adresse d’une mémoire tampon allouée par le minidriver. Lors du retour, la mémoire tampon contient la valeur précédente des données binaires de la propriété. Si ces informations ne sont pas nécessaires, ce paramètre peut être défini sur NULL.

bMustExist

Indique si la propriété doit exister. Si la valeur est TRUE, la propriété doit exister ; si la valeur est FALSE, la propriété n’a pas besoin d’exister.

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 alloue une mémoire tampon et stocke son adresse dans le paramètre ppbVal . Le minidriver doit libérer la mémoire tampon en appelant CoTaskMemFree.