estrutura SCSI_PNP_REQUEST_BLOCK (storport.h)

Artigo
08/07/2023

A estruturaSCSI_PNP_REQUEST_BLOCK é uma versão especial de um SCSI_REQUEST_BLOCK que é usado para solicitações PNP (plug-and-play).

Observação

Os modelos de driver de porta SCSI e driver de miniporto SCSI podem ser alterados ou indisponíveis no futuro. Em vez disso, recomendamos usar os modelos de driver do Storport e do driver de miniporto storport .

Sintaxe

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;

Membros

Length

O tamanho, em bytes, da estrutura SCSI_PNP_REQUEST_BLOCK .

Function

A operação a ser executada. Para a estrutura SCSI_PNP_REQUEST_BLOCK , esse membro é sempre definido como SRB_FUNCTION_PNP.

SrbStatus

O status da solicitação concluída. O driver de miniporte deve definir esse valor antes de notificar o driver storport que a solicitação foi concluída. Um driver de miniporto notifica o driver storport que a solicitação foi concluída chamando a rotina StorPortNotification com um tipo de notificação requestComplete. Para obter uma lista de possíveis valores de status, consulte SCSI_REQUEST_BLOCK.

PnPSubFunction

Este membro não é usado no momento. Os drivers de miniporta ignoram esse membro.

PathId

O identificador de barramento ou porta SCSI para a solicitação. Esse valor é baseado em zero.

TargetId

O controlador de destino ou o identificador de dispositivo no barramento.

Lun

O LUN (número de unidade lógica) do dispositivo.

PnPAction

A ação plug-and-play a ser executada. Esse membro pode ter um dos seguintes valores:

Valor	Significado
StorStartDevice (0x00)	Inicie o dispositivo.
StorRemoveDevice (0x02)	Remova o dispositivo.
StorStopDevice (0x04)	Pare o dispositivo.
StorQueryCapabilities (0x09)	Consulte os recursos do dispositivo.
StorQueryResourceRequirements (0x0B)	Consulte os requisitos de recurso para o dispositivo.
StorFilterResourceRequirements (0x0D)	Filtre os requisitos de recurso para o dispositivo.
StorSupriseRemoval (0x17)	Remoção surpresa do dispositivo. Esse valor foi adicionado no Windows 7.

SrbFlags