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. |