Partager via


Bibliothèque de services de pilotes WIA

La bibliothèque de services de pilotes WIA contient des fonctions qu’un minidriver WIA peut appeler pour obtenir de l’aide dans l’exécution des tâches suivantes :

Un minidriver WIA appelle la plupart de ces fonctions à partir de ses méthodes d’interface IWiaMiniDrv en fonction des besoins. Chaque minidriver WIA, toutefois, doit appeler la fonction wiasCreateDrvItem dans la méthode IWiaMiniDrv ::d rvInitializeWia pour créer des éléments de pilote. Chaque appel réussi à une fonction wiasCreateDrvItem crée un objet d’élément IWiaDrvItem , qui est utilisé dans l’arborescence des éléments du minidriver. Plusieurs méthodes d’interface IWiaDrvItem ont un paramètre de type IWiaDrvItem, y compris IWiaDrvItem ::AddItemToFolder, IWiaDrvItem ::GetFirstChildItem, IWiaDrvItem ::GetNextSiblingItem et IWiaDrvItem ::GetParentItem. En outre, la fonction wiasGetDrvItem a un paramètre de ce type.

La bibliothèque de services de pilotes fournit les fonctions suivantes.

Créer et gérer une arborescence d’éléments

Fonction Description
wiasCreateChildAppItem Crée un élément d’application et l’insère en tant qu’enfant de l’élément (parent) spécifié.
wiasCreateDrvItem Crée un objet IWiaDrvItem .
wiasGetChildrenContexts Récupère un tableau de contextes d’élément appartenant aux enfants de l’élément actif.
wiasGetContextFromName Récupère le contexte de l’élément pour un nom d’élément.
wiasGetDrvItem Récupère un élément de pilote.
wiasGetRootItem Récupère le contexte d’élément racine d’un élément WIA spécifié.

Erreurs de journalisation et messages de suivi

Fonction Description
wiasCreateLogInstance Crée un instance d’un objet de journalisation.
wiasDebugError Imprime une chaîne d’erreur de débogage dans la console de débogage Gestionnaire de périphériques. La couleur de sortie est toujours rouge. Cette fonction est fournie à des fins de compatibilité uniquement. Il est recommandé d’utiliser WIAS_ERROR à la place.
wiasDebugTrace Imprime une chaîne de trace de débogage dans la console de débogage Gestionnaire de périphériques. Cette fonction est fournie à des fins de compatibilité uniquement. Il est recommandé d’utiliser WIA_TRACE à la place.
wiasFormatArgs Met en forme une liste d’arguments dans une chaîne empaquetée pour la journalisation.
wiasPrintDebugHResult Imprime une chaîne HRESULT sur la console de débogage Gestionnaire de périphériques. Cette fonction est fournie à des fins de compatibilité uniquement. Il est obsolète et n’est plus pris en charge. Utilisez WIAS_LHRESULT à la place.

Lire et stocker des propriétés d’élément

Fonction Description
wiasCreatePropContext Alloue un contexte de propriété pour indiquer laquelle des propriétés d’un élément change.
wiasFreePropContext Libère la mémoire occupée par une structure WIA_PROPERTY_CONTEXT .
wiasGetChangedValueFloat Détermine si une propriété avec une valeur à virgule flottante a été modifiée par une application.
wiasGetChangedValueGuid Détermine si une propriété avec une valeur GUID a été modifiée par une application.
wiasGetChangedValueLong Détermine si une propriété avec une valeur entière longue a été modifiée par une application.
wiasGetChangedValueStr Détermine si une propriété avec une valeur de chaîne a été modifiée par une application.
wiasGetItemType Indique un élément racine ou enfant.
wiasGetPropertyAttributes Récupère les indicateurs d’accès et les valeurs valides pour un ensemble de propriétés.
wiasIsPropChanged Teste si la propriété spécifiée a été modifiée par une application.
wiasReadMultiple Lit plusieurs propriétés à partir d’un élément WIA.
wiasReadPropBin Lit une propriété binaire unique à partir d’un élément WIA.
wiasReadPropFloat Récupère une valeur de propriété à virgule flottante à partir d’un élément WIA.
wiasReadPropGuid Récupère une valeur de propriété GUID à partir d’un élément WIA.
wiasReadPropLong Récupère une valeur de propriété entier long à partir d’un élément WIA.
wiasReadPropStr Récupère une valeur de propriété de chaîne à partir d’un élément WIA.
wiasSetItemPropAttribs Définit les indicateurs d’accès et les valeurs valides pour l’ensemble de propriétés d’un élément.
wiasSetItemPropNames Écrit les noms de propriétés dans les propriétés d’élément.
wiasSetPropChanged Modifie un contexte de propriété pour indiquer qu’une propriété est en cours de modification.
wiasSetPropertyAttributes Définit les indicateurs d’accès et les valeurs de propriété des propriétés d’un élément.
wiasSetValidFlag Définit les valeurs valides pour une propriété WIA_PROP_FLAG.
wiasSetValidListFloat Définit les valeurs valides pour une propriété WIA_PROP_LIST de type sub-VT_R4.
wiasSetValidListGuid Définit les valeurs valides pour une propriété WIA_PROP_LIST de sous-type VT_CLSID.
wiasSetValidListLong Définit les valeurs valides pour une propriété WIA_PROP_LIST de type sub-VT_I4.
wiasSetValidListStr Définit les valeurs valides pour une propriété WIA_PROP_LIST de type sub-VT_BSTR.
wiasSetValidRangeFloat Spécifie la plage de valeurs valides pour une propriété WIA_PROP_RANGE de sous-type VT_R4.
wiasSetValidRangeLong Spécifie la plage de valeurs valides pour une propriété WIA_PROP_RANGE de sous-type VT_I4.
wiasUpdateValidFormat Mises à jour le format valide du contexte de propriété pour le minidriver actuel.
wiasValidateItemProperties Valide une liste de propriétés d’élément simples par rapport à leurs valeurs valides actuelles.
wiasWriteMultiple Écrit plusieurs valeurs de propriété dans un élément WIA (les propriétés peuvent être de différents types).
wiasWritePropBin Écrit une seule valeur de propriété binaire dans un élément WIA.
wiasWritePropFloat Écrit une valeur de propriété à virgule flottante dans un élément WIA.
wiasWritePropGuid Écrit une valeur de propriété GUID dans un élément WIA.
wiasWritePropLong Écrit une valeur de propriété entier long dans un élément WIA.
wiasWritePropStr Écrit une valeur de propriété de chaîne dans un élément WIA.

Mettre à jour et transférer des données

Fonction Description
wiasDownSampleBuffer Prend une mémoire tampon de données de pixels et la sous-échantillonne à la taille spécifiée.
wiasGetImageInformation Récupère les informations de contexte de transfert à partir d’un élément.
wiasParseEndorserString Analyse une chaîne d’approbation, en remplaçant les jetons définis par le service WIA et définis par le fournisseur dans la chaîne par des valeurs associées aux jetons.
wiasSendEndOfPage Appelle la routine de rappel du client pendant un transfert de données, en envoyant le nombre total de pages actuel.
wiasUpdateScanRect Mises à jour les tailles de zone d’analyse de l’appareil d’analyse.
wiasWriteBufToFile Écrit le contenu d’une mémoire tampon de page temporaire dans un fichier image.
wiasWritePageBufToFile Écrit le contenu d’une mémoire tampon de page temporaire dans un fichier image. Utilisez cette fonction pour écrire une page dans un fichier TIFF de plusieurs pages.