Commandes facultatives

Les commandes suivantes peuvent être implémentées par le microdriver, mais il n’est pas nécessaire de le faire.

CMD_GETSUPPORTEDFILEFORMATS

Appelé par le pilote à plat WIA pour obtenir le nombre de formats de fichier supplémentaires. Deux membres de la structure VAL passée doivent être renseignés : lVal doit être défini sur le nombre de formats de fichier supplémentaires ; pGuid doit pointer vers un tableau de GUID de format d’image. La mémoire allouée pour ce tableau est détenue par le microdriver et ne doit être libérée que par lui.

Les formats d’image sont répertoriés dans wiadef.h ou peuvent être définis en tant que formats personnalisés. Notez que, étant donné que les formats BMP (fichier) et MEMORYBMP (mémoire) sont des formats requis, le pilote à plat WIA les ajoute automatiquement. Le microdriver ne doit pas les ajouter à sa liste étendue.

Cette commande est facultative, sauf si l’appareil peut prendre en charge des formats de fichiers supplémentaires.

CMD_GETSUPPORTEDMEMORYFORMATS

Appelé par le pilote à plat WIA pour obtenir le nombre de formats de mémoire supplémentaires. Deux membres de la structure VAL passée doivent être renseignés : lVal doit être défini sur le nombre de formats de mémoire supplémentaires ; pGuid doit pointer vers un tableau de GUID de format d’image. La mémoire allouée pour ce tableau est détenue par le microdriver et ne doit être libérée que par lui.

Les formats d’image sont répertoriés dans wiadef.h ou peuvent être définis en tant que formats personnalisés. Notez que, étant donné que les formats BMP (fichier) et MEMORYBMP (mémoire) sont des formats requis, le pilote à plat WIA les ajoute automatiquement. Le microdriver ne doit pas les ajouter à sa liste étendue.

Cette commande est facultative, sauf si l’appareil peut prendre en charge des formats de mémoire supplémentaires.

CMD_SETFORMAT

Le pilote de classe envoie cette commande pour définir le format actuel comme demandé par l’application. Le membre pGuid de la structure VAL contient le GUID de format d’image. Le microdriver doit enregistrer cet ID de format d’image dans son contexte privé afin de suivre le paramètre de format d’image actuel.

Les microdrivers doivent être utilisés pour prendre en charge cette commande uniquement s’ils indiquent des formats avancés. Étant donné que le pilote de classe n’a aucun moyen de valider les données dans des formats étendus, il incombe au microdriver de générer les données appropriées. Lors du transfert de données dans un format étendu, toutes les données doivent être transférées, y compris les en-têtes d’image. Par exemple, si votre pilote signale qu’il prend en charge le format JPEG, tous les fichiers JPEG doivent être transférés, pas seulement les bits d’image.

Le pilote de classe possède la mémoire pointée par le membre pGuid de la structure VAL, donc le microdriver ne doit pas la libérer.

Notez que cette commande n’affecte pas la façon dont un microdriver répond aux appels à sa fonction Scan . Comme d’habitude, le microdriver doit vérifier les valeurs des paramètres lPhase, pScanInfo et lLength de cette fonction, et placer les données dans les mémoires tampons pointées par les paramètres pBuffer et pReceived selon les besoins.

Les pilotes qui prennent uniquement en charge les fichiers dans les formats WiaImgFmt_BMP et WiaImgFmt_MEMORYBMP (les formats par défaut pour les microdrivers) peuvent recevoir la commande CMD_SETFORMAT. Ces pilotes peuvent ignorer cette commande, car le pilote de classe gère tous les transferts de données à l’aide des formats par défaut.

CMD_SETSCANMODE

Appelé par le pilote à plat WIA pour définir le mode d’analyse (préversion ou finale) de l’appareil du microdriver. Le membre lVal de la structure VAL contient l’une des valeurs suivantes, qui sont toutes deux définies dans wiamicro.h :

• SCANMODE_PREVIEWSCAN − Mode d’analyse en préversion

• SCANMODE_FINALSCAN − Mode d’analyse final

CMD_SETSTIDEVICEHKEY

Appelé par le pilote WIA Flatbed pour permettre au microdriver de lire les entrées du Registre dans la section du Registre installé. Cette commande fournit la clé de registre HKEY installée de l'appareil STI au microdriver, afin qu'il puisse accéder aux valeurs de registre privé de son appareil. Le membre pHandle de la structure VAL contiendra un pointeur vers la clé HKEY donnée au pilote à plat WIA pendant la méthode IStiUSD ::Initialize de STI. Il s’agit du HKEY de niveau supérieur de la section de l’appareil installé. La clé DeviceData peut être ouverte directement à l’aide de cette clé HKEY. Pour plus d’informations, consultez fichiers INF pour les appareils WIA .