Condividi tramite


SCSI_PNP_REQUEST_BLOCK struttura (storport.h)

La strutturaSCSI_PNP_REQUEST_BLOCK è una versione speciale di una SCSI_REQUEST_BLOCK usata per le richieste di plug and play (PNP).

Nota

I modelli di driver di porta SCSI e miniport SCSI possono essere modificati o non disponibili in futuro. È invece consigliabile usare i modelli di driver Storport e Miniport Storport.

Sintassi

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;

Members

Length

Dimensioni, in byte, della struttura SCSI_PNP_REQUEST_BLOCK .

Function

Operazione da eseguire. Per la struttura SCSI_PNP_REQUEST_BLOCK , questo membro è sempre impostato su SRB_FUNCTION_PNP.

SrbStatus

Stato della richiesta completata. Il driver miniport deve impostare questo valore prima di inviare una notifica al driver Storport che la richiesta è stata completata. Un driver miniport notifica al driver Storport che la richiesta è stata completata chiamando la routine StorPortNotification con un tipo di notifica RequestComplete. Per un elenco dei valori di stato possibili, vedere SCSI_REQUEST_BLOCK.

PnPSubFunction

Questo membro non viene attualmente usato. I driver miniport ignorano questo membro.

PathId

La porta SCSI o l'identificatore del bus per la richiesta. Questo valore è zero basato.

TargetId

Controller di destinazione o identificatore del dispositivo nel bus.

Lun

Numero di unità logica (LUN) del dispositivo.

PnPAction

Azione plug and play da eseguire. Questo membro può avere uno dei valori seguenti:

Valore Significato
StorStartDevice (0x00) Avviare il dispositivo.
StorRemoveDevice (0x02) Rimuovere il dispositivo.
StorStopDevice (0x04) Arrestare il dispositivo.
StorQueryCapabilities (0x09) Eseguire query sulle funzionalità del dispositivo.
StorQueryResourceRequirements (0x0B) Eseguire query sui requisiti delle risorse per il dispositivo.
StorFilterResourceRequirements (0x0D) Filtrare i requisiti delle risorse per il dispositivo.
StorSupriseRemoval (0x17) Rimozione sorpresa del dispositivo. Questo valore è stato aggiunto in Windows 7.

SrbFlags

Il driver miniport deve ignorare questo membro.

DataTransferLength

Il driver miniport deve ignorare questo membro.

TimeOutValue

L'intervallo, in secondi, che la richiesta può essere eseguita prima del driver Storport determina il timeout della richiesta.

DataBuffer

Il driver miniport deve ignorare questo membro.

SenseInfoBuffer

Il driver miniport deve ignorare questo membro.

NextSrb

Il driver miniport deve ignorare questo membro.

OriginalRequest

Il driver miniport deve ignorare questo membro.

SrbExtension

Puntatore all'estensione SRB. Un driver miniport non deve usare questo membro se imposta SrbExtensionSize su zero nella struttura HW_INITIALIZATION_DATA . Il driver Storport non inizializza la memoria a cui punta questo membro. L'HBA può accedere direttamente ai dati scritti dal driver miniport nell'estensione SRB. Un driver miniport può ottenere l'indirizzo fisico dell'estensione SRB chiamando la routine StorPortGetPhysicalAddress .

SrbPnPFlags

Flag PNP. Attualmente, l'unico flag consentito è SRB_PNP_FLAGS_ADAPTER_REQUEST, che indica che la richiesta PNP è per l'adattatore e non per uno dei dispositivi nella scheda. Se questo flag è impostato, il driver miniport deve ignorare i valori in PathId, TargetId e Lun.

Reserved

Riservato per l'utilizzo nel sistema.

Reserved4[16]

Riservato per l'utilizzo nel sistema.

Commenti

Il driver Storport invia SCSI_PNP_REQUEST_BLOCK richieste a un driver miniport per informare il driver miniport di eventi plug and play di Windows che influiscono sui dispositivi di archiviazione connessi alla scheda.

Il driver Storport chiama HwStorBuildIo per passare SRBs al driver miniport. HwStorBuildIo controlla il membro della funzione di SRB per determinare il tipo di SRB. Se il membro della funzione è impostato su SRB_FUNCTION_PNP, SRB è una struttura di tipo SCSI_PNP_REQUEST_BLOCK.

Requisiti

Requisito Valore
Intestazione storport.h (include Storport.h, Minitape.h, Srb.h)

Vedi anche

HwStorBuildIo

SCSI_REQUEST_BLOCK

StorPortNotification