SCSI_REQUEST_BLOCK 구조체(srb.h)

SCSI_REQUEST_BLOCK 구조체는 SRB 함수와 연결됩니다.

구문

typedef struct _SCSI_REQUEST_BLOCK {
  USHORT                     Length;
  UCHAR                      Function;
  UCHAR                      SrbStatus;
  UCHAR                      ScsiStatus;
  UCHAR                      PathId;
  UCHAR                      TargetId;
  UCHAR                      Lun;
  UCHAR                      QueueTag;
  UCHAR                      QueueAction;
  UCHAR                      CdbLength;
  UCHAR                      SenseInfoBufferLength;
  ULONG                      SrbFlags;
  ULONG                      DataTransferLength;
  ULONG                      TimeOutValue;
  PVOID                      DataBuffer;
  PVOID                      SenseInfoBuffer;
  struct _SCSI_REQUEST_BLOCK *NextSrb;
  PVOID                      OriginalRequest;
  PVOID                      SrbExtension;
  union {
    ULONG InternalStatus;
    ULONG QueueSortKey;
    ULONG LinkTimeoutValue;
  };
  ULONG                      Reserved;
  UCHAR                      Cdb[16];
} SCSI_REQUEST_BLOCK, *PSCSI_REQUEST_BLOCK;

멤버

Length

이 구조체의 크기(바이트)를 지정합니다.

Function

수행할 작업을 지정합니다. 이 작업은 다음 값 중 하나일 수 있습니다.

SrbStatus

완료된 요청의 상태 반환합니다. 이 멤버는 요청Complete를 사용하여 ScsiPortNotification을 호출하여 요청이 완료되었음을 OS 관련 드라이버에 알리기 전에 미니포트 드라이버에서 설정해야 합니다. 이 멤버의 값은 다음 중 하나일 수 있습니다.

ScsiStatus

HBA 또는 대상 디바이스에서 반환된 SCSI 상태 반환합니다. 상태 SUCCESS가 아닌 경우 미니포트 드라이버는 SrbStatus 멤버를 SRB_STATUS_ERROR 설정해야 합니다.

PathId

요청에 대한 SCSI 포트 또는 버스를 나타냅니다. 이 값은 0부터 시작합니다.

TargetId

버스의 대상 컨트롤러 또는 디바이스를 나타냅니다.

Lun

디바이스의 논리적 단위 번호를 나타냅니다.

QueueTag

OS 관련 포트 드라이버에서 할당한 큐 태그 값을 포함합니다. 이 멤버가 태그가 지정된 큐에 사용되는 경우 HBA는 RU에 대한 요청의 내부 큐를 지원하고 미니포트 드라이버는 이 HBA에 대한 PORT_CONFIGURATION_INFORMATION TaggedQueueing을TRUE 로 설정합니다.

QueueAction

SRB_FLAGS_QUEUE_ACTION_ENABLE 플래그를 설정할 때 사용할 태그가 지정된 큐 메시지를 나타냅니다. 값은 SCSI 사양에 따라 정의된 SRB_SIMPLE_TAG_REQUEST, SRB_HEAD_OF_QUEUE_TAG_REQUEST 또는 SRB_ORDERED_QUEUE_TAG_REQUEST 중 하나일 수 있습니다.

CdbLength

SCSI-2 이상 명령 설명자 블록의 크기(바이트)를 나타냅니다.

SenseInfoBufferLength

요청 감지 버퍼의 크기(바이트)를 나타냅니다. 언더런이 발생하는 경우 미니포트 드라이버는 이 멤버를 실제로 전송된 바이트 수로 업데이트해야 합니다.

SrbFlags

요청에 대한 다양한 매개 변수 및 옵션을 나타냅니다. SrbFlags 는 SRB_FLAGS_UNSPECIFIED_DIRECTION 설정되고 하위 DMA 어댑터의 미니포트 드라이버가 SRB_FLAGS_DATA_IN 또는 SRB_FLAGS_DATA_OUT 업데이트해야 하는 경우를 제외하고 읽기 전용입니다. 이 멤버는 다음 플래그 중 하나 이상을 설정할 수 있습니다.

DataTransferLength

데이터 버퍼의 크기(바이트)를 나타냅니다. 언더런이 발생하는 경우 미니포트 드라이버는 이 멤버를 실제로 전송된 바이트 수로 업데이트해야 합니다.

TimeOutValue

OS 관련 포트 드라이버에서 시간 초과를 고려할 수 있기 전에 요청이 실행될 수 있는 간격(초)을 나타냅니다. 포트 드라이버가 이미 수행하므로 미니포트 드라이버는 요청 시간을 초과할 필요가 없습니다.

DataBuffer

데이터 버퍼를 가리킵니다. 미니포트 드라이버가 HBA에 대한 PORT_CONFIGURATION_INFORMATION MapBuffers 를 TRUE 로 설정하지 않는 한 미니포트 드라이버는 이 값을 데이터 포인터로 사용하면 안 됩니다. 그러나 SRB_FUNCTION_IO_CONTROL 요청의 경우 미니포트 드라이버는 MapBuffers 값에 관계없이 이 값을 데이터 포인터로 사용할 수 있습니다.

SenseInfoBuffer

요청 감지 버퍼를 가리킵니다. 미니포트 드라이버는 CHECK 조건 후에 요청 감지 데이터를 제공할 필요가 없습니다.

NextSrb

이 요청이 적용되는 SCSI_REQUEST_BLOCK 나타냅니다. 요청의 작은 하위 집합만 두 번째 SRB를 사용합니다(예: SRB_FUNCTION_ABORT_COMMAND).

OriginalRequest

이 요청에 대한 IRP를 가리킵니다. 이 멤버는 드라이버를 최소화하는 데 관련이 없습니다.

SrbExtension

Srb 확장을 가리킵니다. 미니포트 드라이버는 SCSI_HW_INITIALIZATION_DATA SrbExtensionSize 를 0으로 설정하는 경우 이 멤버를 사용하지 않아야 합니다. SrbExtension의 메모리는 OS 관련 포트 드라이버에 의해 초기화되지 않으며, 미니포트 드라이버 결정 데이터는 HBA에서 직접 액세스할 수 있습니다. 해당 물리적 주소는 SrbExtension 포인터를 사용하여 ScsiPortGetPhysicalAddress를 호출하여 가져올 수 있습니다.

InternalStatus

SrbStatus 대신 SCSI 포트 드라이버에서 요청이 미니포트 드라이버에 전달될 수 없을 때마다 완료된 요청의 상태 보고하는 데 사용됩니다. 이러한 경우 SrbStatus 는 SRB_STATUS_INTERNAL_ERROR 설정됩니다. 이 멤버는 SCSI 포트와 클래스 드라이버 간의 통신에만 사용되며 미니포트 드라이버에서 사용하면 안 됩니다.

QueueSortKey

대상 디바이스의 유형에 따라 미디어 시작부터 오프셋 또는 0을 지정합니다.

LinkTimeoutValue

링크 시간 제한 값입니다.

Reserved

예약되어 있습니다.

Cdb[16]

대상 디바이스로 보낼 SCSI-2 이상 명령 설명자 블록을 지정합니다.

설명

Windows 스토리지 클래스 및 필터 드라이버는 다음 함수 값이 있는 SRB를 시스템 포트 드라이버로 보낼 수 있습니다.

• 클래스 드라이버가 PathId, TargetId 및 Lun 멤버에 의해 SRB에서 식별된 주변 장치를 지원함을 나타내는 SRB_FUNCTION_CLAIM_DEVICE.
• SRB_ATTACH_DEVICE 클래스 드라이버 위에 계층화된 필터 드라이버가 특정 주변 디바이스에 대한 요청을 먼저 필터 드라이버로 라우팅하려고 함을 나타냅니다.
• 클래스 드라이버가 특정 주변 장치에 대한 클레임을 해제하고 있음을 나타내는 SRB_FUNCTION_RELEASE_DEVICE.
• SRB_FUNCTION_FLUSH_QUEUE 포트 드라이버에서 현재 큐에 대기 중인 요청의 취소를 특정 주변 장치로 요청합니다.
• 포트 드라이버가 고정된 요청 큐를 특정 주변 장치로 해제하도록 요청하는 SRB_FUNCTION_RELEASE_QUEUE.

이전 SRB_FUNCTION_XXX 는 SCSI 미니포트 드라이버로 전송된 SRB에서 설정되지 않습니다. SRB_FUNCTION_REMOVE_DEVICE 이후 버전의 시스템에서 사용하도록 정의됩니다. SCSI 미니포트 드라이버로 전송되는 SRB에서도 설정되지 않습니다. SRB_FUNCTION_WMI_REQUEST SCSI_WMI_REQUEST_BLOCK만 유효합니다. 스토리지 클래스 또는 필터 드라이버는 이를 사용하여 포트 드라이버에 WMI 요청을 보냅니다.

요구 사항

추가 정보

ExFreePool

ExInterlockedFreeToZone

HW_INITIALIZATION_DATA(SCSI)

SCSI(PORT_CONFIGURATION_INFORMATION)

SCSI_WMI_REQUEST_BLOCK

SRB_IO_CONTROL

ScsiPortGetPhysicalAddress

ScsiPortGetSrb

ScsiPortIoMapTransfer

ScsiPortNotification