SAMPLE : IRPQ.exe indique comment faire pour gérer le pilote Windows NT Queuing IRP

   File         Description
   ----------------------------------------------------------------------

   .\sys        A full-duplex asynchronous driver with driver managed Irp
                queues and cancelable I/O.

   .\exe        A multithreaded asynchronous test application that uses
                APCs.

   .\filter     A transparent passthrough filter driver.

   .\kd         A WinDbg kernel debugger extension.
				

   File             Description
   ------------------------------------------------------------------------

   Dirs
   Irpq.htm          Documentation for the sample (a copy of this text).
   Common.h          Common header file.

   Exe\Makefile
   Exe\Sources       Generic file for building the application.
   Exe\Parse.c       Command line parsing code.
   Exe\Stolen.h      Linked List manipulation macros borrowed from NTDDK.h
                     for the application's use.
   Exe\Testirpq.c    Main test application code.
   Exe\Testirpq.h    Application main header file.

   Filter\Makefile
   Filter\Sources    Generic file for building the driver.
   Filter\Filter.c   Main filter driver code.
   Filter\Filter.h   Main filter driver header file.
   Filter\Irpqf.ini  Install file for the filter driver.
   Filter\Irpqf.rc   Resource file.

   Kd\Makefile
   Kd\Sources        Generic file for building the WinDbg kernel debugger
                     extension.
   Kd\Help.c         Help display code for the extension.
   Kd\IRPQkd.c       Extension specific code.
   Kd\IRPQkd.def     Extension export definitions.
   Kd\IRPQkd.h       Main header file.
   Kd\IRPQkd.rc      Extension resource file.
   Kd\Kdexts.c       Generic extension routines.

   Sys\Makefile
   Sys\Sources       Generic file for building the driver.
   Sys\Debug.h       Driver debug definitions.
   Sys\Driver.c      Main driver file.
   Sys\Ioctl.c       IOCTL path.
   Sys\Irpq.c        IRP queuing code.
   Sys\Irpq.h        Main driver header.
   Sys\Irpq.ini      Install file for the driver.
   Sys\Irpq.rc       Resource file.
   Sys\Read.c        Read path.
   Sys\Write.c       Write path.
				

Retour au début

Procédures pas à pas : création de l'exemple

1. Créer les modules dans un l'environnement de génération gratuitement ou CHECKED comme suit :
   
   BLD
   
   Remarque : tous les modules sont placés dans %NTDDK%\LIB\*\FREE | activé sur votre ordinateur de build.
2. Copiez les pilotes nouvellement intégrées au répertoire %SystemRoot%\system32\drivers l'ordinateur cible. Copier le application nouvellement intégrée et les IRPQ*.INI fichiers sur votre ordinateur cible. Copiez l'extension du débogueur IRPQKD.DLL dans le dossier dans lequel vous installé windbg.exe sur votre ordinateur ordinateur hôte.
3. Mettre à jour Registre l'ordinateur cible en exécution RegIni.exe sur le fichier IRPQ*.ini. Par exemple :
   
   REGINI IRPQ.ini
   REGINI IRPQF.ini
   
   Cela ajoute clés de pilote au dossier du Registre suivant :
   

         HKLM\SYSTEM\CurrentControlSet\Services
   						

   
   Vous pouvez vérifier que la clé a été ajoutée en exécutant RegEdit32.exe et examiner les clés \IRPQ*.
4. Redémarrer l'ordinateur cible pour que les modifications du Registre prennent effet. Remarque : vos pilotes ne charge pas jusqu'à ce que vous redémarriez.
5. Charger le pilote à partir de la ligne de commande comme suit :
   
   NET START IRPQ
   
   Si vous utilisez le pilote de filtre vous pouvez utiliser la syntaxe suivante :
   
   NET START IRPQF
   
   Cela va charger le pilote IRPQ.sys ainsi.
6. Exécutez l'application de test à partir de la ligne de commande.
   
   Irpq Utilisation: [-nombre r] [-nombre w] [-i compter] <-t> <-c> <-k>
   
   Options :
   
   [-nombre r] Nombre de lecture demandes à valider.
   
   [-nombre w] Nombre de écriture demandes à valider.
   
   [-i compter] Nombre de DeviceIoControl demandes à valider.
   
   Boucle <-t> test. En continu enregistre des demandes de lecture, écriture et/ou DeviceIoControl jusqu'à ce qu'interrompu.
   
   Si vous utilisez cette option, <count> arguments sont ignorés.
   
   <-c> teste Annuler chemin le pilote pour les demandes en attente.
   
   Toutes les demandes sont validées et ensuite annulées.
   
   Remarque : le <-c> et options <-t> sont mutuellement exclusifs.
   
   <-k> teste chemin d'accès du pilote IRP_MJ_CLEANUP en validation les demandes requis et puis en fermant le descripteur de fichier.
   
   Par exemple :
   

      irpq -r 12 : post 12 Read requests.
   
      irpq -r 12 -c : post 12 Read requests, then cancel any outstanding
                      requests.
   
      irpq -r 12 -k : post 12 Read requests, then force IRP_MJ_CLEANUP.
   
      irpq -r 12 -t : continuously post Read requests.
   
      irpq -r 12 -w 12 -i 12 -t : continuously post Read, Write, and Ioctl
                                  requests.

7. Décharger le pilote à partir de la ligne de commande comme suit :
   
   NET STOP IRPQ *

Retour au début