structure SCSI_PNP_REQUEST_BLOCK (srb.h)

Article
02/07/2025

La structureSCSI_PNP_REQUEST_BLOCK est une version spéciale d’un SCSI_REQUEST_BLOCK utilisé pour les requêtes PNP (Plug-and-Play).

Remarque Le pilote de port SCSI et les modèles de pilotes miniport SCSI peuvent être modifiés ou indisponibles à l’avenir. Au lieu de cela, nous vous recommandons d’utiliser le du pilote Storport et modèles de pilotes Storport miniport.

Syntaxe

typedef struct _SCSI_PNP_REQUEST_BLOCK {
  USHORT                     Length;
  UCHAR                      Function;
  UCHAR                      SrbStatus;
  UCHAR                      PnPSubFunction;
  UCHAR                      PathId;
  UCHAR                      TargetId;
  UCHAR                      Lun;
  STOR_PNP_ACTION            PnPAction;
  ULONG                      SrbFlags;
  ULONG                      DataTransferLength;
  ULONG                      TimeOutValue;
  PVOID                      DataBuffer;
  PVOID                      SenseInfoBuffer;
  struct _SCSI_REQUEST_BLOCK *NextSrb;
  PVOID                      OriginalRequest;
  PVOID                      SrbExtension;
  ULONG                      SrbPnPFlags;
  ULONG                      Reserved;
  UCHAR                      Reserved4[16];
} SCSI_PNP_REQUEST_BLOCK, *PSCSI_PNP_REQUEST_BLOCK;

Membres

Length

Taille, en octets, de la structure SCSI_PNP_REQUEST_BLOCK.

Function

Opération à effectuer. Pour la structure SCSI_PNP_REQUEST_BLOCK, ce membre est toujours défini sur SRB_FUNCTION_PNP.

SrbStatus

État de la demande terminée. Le pilote miniport doit définir cette valeur avant d’avertir le pilote Storport que la demande est terminée. Un pilote miniport informe le pilote Storport que la requête est terminée en appelant la routine StorPortNotification avec un type de notification RequestComplete. Pour obtenir la liste des valeurs d’état possibles, consultez SCSI_REQUEST_BLOCK.

PnPSubFunction

Ce membre n’est pas utilisé actuellement. Les pilotes miniport ignorent ce membre.

PathId

Identificateur de bus ou de port SCSI pour la requête. Cette valeur est basée sur zéro.

TargetId

Le contrôleur cible ou l’identificateur d’appareil sur le bus.

Lun

Numéro d’unité logique (LUN) de l’appareil.

PnPAction

Action plug-and-play à effectuer. Ce membre peut avoir l’une des valeurs suivantes :

Valeur	Signification
storStartDevice 0x00	Démarrez l’appareil.
storRemoveDevice 0x02	Supprimez l’appareil.
StorStopDevice 0x04	Arrêtez l’appareil.
StorQueryCapabilities 0x09	Interrogez les fonctionnalités de l’appareil.
StorQueryResourceRequirements 0x0B	Interrogez les besoins en ressources de l’appareil.
StorFilterResourceRequirements 0x0D	Filtrez les exigences en matière de ressources pour l’appareil.
StorSupriseRemoval 0x17	Suppression surprise de l’appareil. Cette valeur a été ajoutée dans Windows 7.

SrbFlags