PORT_CONFIGURATION_INFORMATION 구조체(storport.h)

아티클
08/07/2023

PORT_CONFIGURATION_INFORMATION HBA(호스트 버스 어댑터)에 대한 구성 정보를 포함합니다.

구문

typedef struct _PORT_CONFIGURATION_INFORMATION {
  ULONG                                  Length;
  ULONG                                  SystemIoBusNumber;
  INTERFACE_TYPE                         AdapterInterfaceType;
  ULONG                                  BusInterruptLevel;
  ULONG                                  BusInterruptVector;
  KINTERRUPT_MODE                        InterruptMode;
  ULONG                                  MaximumTransferLength;
  ULONG                                  NumberOfPhysicalBreaks;
  ULONG                                  DmaChannel;
  ULONG                                  DmaPort;
  DMA_WIDTH                              DmaWidth;
  DMA_SPEED                              DmaSpeed;
  ULONG                                  AlignmentMask;
  ULONG                                  NumberOfAccessRanges;
  ACCESS_RANGE( )                          *AccessRanges[];
  PVOID                                  MiniportDumpData;
  PVOID                                  Reserved;
  UCHAR                                  NumberOfBuses;
  CCHAR                                  InitiatorBusId[8];
  BOOLEAN                                ScatterGather;
  BOOLEAN                                Master;
  BOOLEAN                                CachesData;
  BOOLEAN                                AdapterScansDown;
  BOOLEAN                                AtdiskPrimaryClaimed;
  BOOLEAN                                AtdiskSecondaryClaimed;
  BOOLEAN                                Dma32BitAddresses;
  BOOLEAN                                DemandMode;
  UCHAR                                  MapBuffers;
  BOOLEAN                                NeedPhysicalAddresses;
  BOOLEAN                                TaggedQueuing;
  BOOLEAN                                AutoRequestSense;
  BOOLEAN                                MultipleRequestPerLu;
  BOOLEAN                                ReceiveEvent;
  BOOLEAN                                RealModeInitialized;
  BOOLEAN                                BufferAccessScsiPortControlled;
  UCHAR                                  MaximumNumberOfTargets;
  UCHAR                                  SrbType;
  UCHAR                                  AddressType;
  UCHAR                                  ReservedUchars[2];
  ULONG                                  SlotNumber;
  ULONG                                  BusInterruptLevel2;
  ULONG                                  BusInterruptVector2;
  KINTERRUPT_MODE                        InterruptMode2;
  ULONG                                  DmaChannel2;
  ULONG                                  DmaPort2;
  DMA_WIDTH                              DmaWidth2;
  DMA_SPEED                              DmaSpeed2;
  ULONG                                  DeviceExtensionSize;
  ULONG                                  SpecificLuExtensionSize;
  ULONG                                  SrbExtensionSize;
  UCHAR                                  Dma64BitAddresses;
  BOOLEAN                                ResetTargetSupported;
  UCHAR                                  MaximumNumberOfLogicalUnits;
  BOOLEAN                                WmiDataProvider;
  STOR_SYNCHRONIZATION_MODEL             SynchronizationModel;
  PHW_MESSAGE_SIGNALED_INTERRUPT_ROUTINE HwMSInterruptRoutine;
  INTERRUPT_SYNCHRONIZATION_MODE         InterruptSynchronizationMode;
  MEMORY_REGION                          DumpRegion;
  ULONG                                  RequestedDumpBufferSize;
  BOOLEAN                                VirtualDevice;
  UCHAR                                  DumpMode;
  UCHAR                                  DmaAddressWidth;
  ULONG                                  ExtendedFlags1;
  ULONG                                  MaxNumberOfIO;
  ULONG                                  MaxIOsPerLun;
  ULONG                                  InitialLunQueueDepth;
  ULONG                                  BusResetHoldTime;
  ULONG                                  FeatureSupport;
} PORT_CONFIGURATION_INFORMATION, *PPORT_CONFIGURATION_INFORMATION;

멤버

Length

PORT_CONFIGURATION_INFORMATION 구조체의 크기(바이트)입니다. Storport 드라이버에서 초기화된 이 멤버는 구조체 버전으로도 사용됩니다.

SystemIoBusNumber

HBA가 연결된 I/O 버스의 시스템 할당 번호입니다. 미니포트 드라이버는 이 멤버를 수정해서는 안됩니다. 플랫폼에 지정된 AdapterInterfaceType의 여러 I/O 버스가 있을 수 있으므로 해당 값은 시스템 할당입니다.

AdapterInterfaceType

I/O 버스 인터페이스입니다. Storport는 이 멤버를 HW_INITIALIZATION_DATA 구조체의 미니포트 드라이버에서 지정한 값으로 초기화합니다. 미니포트 드라이버는 이 멤버를 수정해서는 안됩니다.

BusInterruptLevel

버스 상대 인터럽트 요청 수준입니다. Storport는 HBA의 인터럽트 사용에 대해 가정하지 않으므로 기본값은 0입니다. Storport는 이 멤버를 초기화하고 미니포트 드라이버는 이 멤버를 수정해서는 안 됩니다.

BusInterruptVector

HBA에서 반환된 버스 상대 벡터입니다. Storport는 HBA의 인터럽트 사용에 대해 가정하지 않으므로 기본값은 0입니다. 이 멤버는 해당 HBA에 대해 BusInterruptLevel 멤버를 설정한 드라이버와 관련이 없습니다. PCIBus와 같은 인터럽트 벡터를 사용하는 I/O 버스 유형에 대한 HBA와 관련이 있습니다. Storport는 이 멤버를 초기화하고 미니포트 드라이버는 이 멤버를 수정해서는 안 됩니다.

InterruptMode

HBA에서 LevelSensitive 또는 래치 ("에지 트리거"라고도 함) 인터럽트 사용 여부를 지정합니다. Storport는 이 멤버를 버스 및 디바이스에 적절한 값(예: PCIBus용 LevelSensitive)으로 초기화합니다. Storport는 이 멤버를 초기화하고 미니포트 드라이버는 이 멤버를 수정해서는 안 됩니다.

MaximumTransferLength

HBA가 단일 전송 작업에서 전송할 수 있는 최대 바이트 수입니다. 기본적으로 이 멤버의 값은 무제한 최대 전송 크기를 나타내는 SP_UNINITIALIZED_VALUE. HBA의 전송 지원이 더 제한된 경우 미니포트 드라이버는 HBA의 전송 용량에 따라 이 멤버를 다시 설정해야 합니다. 미니포트 드라이버의 HwStorInterrupt 루틴이 HBA에서 인터럽트를 사용하지 않도록 설정할 수 없는 경우 드라이버 개발 중에 이 멤버를 조정하여 해당 미니포트 드라이버의 ISR에 소요된 시간이 전체 시스템 성능을 저하시키지 않도록 할 수 있습니다.

NumberOfPhysicalBreaks

스토리지 어댑터가 단일 전송에서 관리할 수 있는 최대 물리적 페이지 수입니다(즉, 분산/수집 지원 범위). 기본적으로 이 멤버의 값은 0x11. 미니포트 드라이버는 스토리지 어댑터의 기능에 따라 이 멤버를 다시 설정해야 합니다.

DmaChannel

하위 HBA에서 사용하는 DMA 채널입니다. 기본적으로 이 멤버의 값은 SP_UNINITIALIZED_VALUE. Storport는 이 멤버를 초기화하고 미니포트 드라이버는 이 멤버를 수정해서는 안 됩니다.

DmaPort

하위 HBA에서 사용하는 DMA 포트입니다. 기본적으로 이 멤버의 값은 SP_UNINITIALIZED_VALUE. Storport는 이 멤버를 초기화하고 미니포트 드라이버는 이 멤버를 수정해서는 안 됩니다.

DmaWidth

HBA가 DMA를 사용하는 경우 DMA 전송의 너비입니다. 기본적으로 이 멤버의 값은 0입니다. Storport는 이 멤버를 초기화하고 미니포트 드라이버는 이 멤버를 수정해서는 안 됩니다.

DmaSpeed

Eisa HBA의 DMA 데이터 전송 속도입니다. Storport는 이 멤버를 초기화하고 미니포트 드라이버는 이 멤버를 수정해서는 안 됩니다.

AlignmentMask

전송 작업에 HBA에 필요한 버퍼에 대한 맞춤 제한을 나타내는 마스크입니다. 유효한 마스크 값의 예로는 0(바이트 정렬), 1(단어 정렬), 3(DWORD 맞춤) 및 7(이중 DWORD 맞춤)이 있습니다. HBA가 분산/수집을 지원하는 경우 미니포트 드라이버는 이 마스크를 설정해야 합니다. 허용되는 다음 맞춤 마스크 값은 wdm.h에 정의되어 있습니다.

값	의미
FILE_BYTE_ALIGNMENT(0x00000000)	데이터가 바이트 정렬됨(디바이스에 대한 맞춤 요구 사항 없음)
FILE_WORD_ALIGNMENT(0x00000001)	데이터는 2 바이트 경계에 맞춰야 합니다.
FILE_LONG_ALIGNMENT(0x00000003)	데이터는 4 바이트 경계에 맞춰야 합니다.
FILE_QUAD_ALIGNMENT(0x00000007)	데이터는 8 바이트 경계에 맞춰야 합니다.
FILE_OCTA_ALIGNMENT(0x0000000f)	데이터는 16비트 경계에 맞춰야 합니다.
FILE_32_BYTE_ALIGNMENT(0x0000001f)	데이터는 32비트 경계에 맞춰야 합니다.
FILE_64_BYTE_ALIGNMENT(0x0000003f)	데이터는 64비트 경계에 맞춰야 합니다.
FILE_128_BYTE_ALIGNMENT(0x0000007f)	데이터는 128비트 경계에 맞춰야 합니다.
FILE_256_BYTE_ALIGNMENT(0x000000ff)	데이터는 256비트 경계에 맞춰야 합니다.
FILE_512_BYTE_ALIGNMENT(0x000001ff)	데이터는 512 바이트 경계에 맞춰야 합니다.

NumberOfAccessRanges

배열의 AccessRanges 요소 수를 지정합니다.

AccessRanges

ACCESS_RANGE 형식 요소의 배열에 대한 포인터입니다. Storport는 액세스 범위에 대한 메모리를 할당하고 이 멤버를 초기화합니다. 미니포트 드라이버는 이 멤버를 수정해서는 안됩니다.

MiniportDumpData

crashdump 또는 최대 절전 모드 중에 사용되는 덤프 컨텍스트에 대한 포인터입니다.

Reserved

시스템용으로 예약되어 있습니다(사전 Windows 8).

NumberOfBuses

어댑터에서 제어하는 버스 수입니다. 기본적으로 이 멤버의 값은 0입니다. 이 멤버의 최대 값은 SCSI_MAXIMUM_BUSES_PER_ADAPTER. 이 멤버는 Windows 8 시작해서 사용할 수 있습니다.

InitiatorBusId[8]

초기자 버스 ID입니다. 입력 InitiatorBusId[0] 에 SP_UNINITIALIZED_VALUE 값이 있는 경우 HBA에서 HBA를 쿼리하여 결정된 특정 값을 사용할 필요가 없는 경우 미니포트 드라이버는 기본값을 할당할 수 있습니다. 그렇지 않으면 미니포트 드라이버는 가능한 경우 포트 드라이버에서 할당한 0이 아닌 값을 사용해야 합니다. 일반적으로 이 값은 MaximumNumberOfTargets에 설정된 값으로 제한됩니다.

ScatterGather

TRUE이면 HBA는 분산/수집을 지원합니다. Storport는 미니포트 드라이버가 분산/수집을 지원해야 하므로 이 멤버를 TRUE 로 초기화합니다. Storport와 함께 작동하는 미니포트 드라이버는 이 값을 수정해서는 안 합니다. (참고: Windows Server 2008 R2 및 Windows 7 이전의 Windows 버전에서는 이 멤버가 FALSE로 설정됩니다. 이 경우 미니포트 드라이버는 이 멤버를 TRUE로 설정해야 합니다. 이 멤버를 TRUE 로 설정하지 않으면 HBA 디바이스가 시작되지 않습니다.)

Master

TRUE이면 HBA는 master 버스입니다. Storport는 미니포트 드라이버가 버스 마스터링 DMA를 지원해야 하므로 이 멤버를 TRUE 로 초기화합니다. Storport와 함께 작동하는 미니포트 드라이버는 이 값을 수정해서는 안 합니다. (참고: Windows Server 2008 R2 및 Windows 7 이전의 Windows 버전에서는 이 멤버가 FALSE로 설정됩니다. 이 경우 미니포트 드라이버는 이 멤버를 TRUE로 설정해야 합니다. 이 멤버를 TRUE 로 설정하지 않으면 HBA 디바이스가 시작되지 않습니다.)

CachesData

TRUE이면 HBA는 데이터를 캐시하거나 주변 장치에서 캐시된 상태를 유지 관리합니다. FALSE인 경우 HBA는 데이터를 캐시하거나 주변 장치에서 캐시된 상태를 유지 관리하지 않습니다. 기본적으로 이 멤버의 값은 FALSE입니다. TRUE로 다시 설정되면 Storport는 파일 시스템 캐시 플러시와 같은 특정 시스템 이벤트가 발생할 때 미니포트 드라이버에 알깁니다.

AdapterScansDown

Storport는 이 멤버를 무시합니다.

AtdiskPrimaryClaimed

Storport는 이 멤버를 사용하지 않으며 미니포트 드라이버는 이 멤버를 설정해서는 안됩니다.

AtdiskSecondaryClaimed

Storport는 이 멤버를 사용하지 않으며 미니포트 드라이버는 이 멤버를 설정해서는 안됩니다.

Dma32BitAddresses

TRUE이면 HBA에는 32개의 주소 줄이 있으며 실제 주소가 0x00FFFFFF보다 큰 메모리에 액세스할 수 있습니다. Storport는 미니포트 드라이버가 버스 너비 DMA를 지원해야 하므로 이 멤버를 TRUE로 초기화합니다. Dma64BitAddresses에 대한 값이 설정되지 않은 경우 기본 DMA 주소 지정이므로 미니포트 드라이버는 이 값을 수정해서는 안됩니다. 참고: 디바이스 하드웨어에서 32비트 주소만 지원되는 경우 Dma64BitAddresses를 0으로 설정해야 합니다.

DemandMode

시스템 DMA 컨트롤러가 단일 주기 작업 대신 수요 모드로 프로그래밍되어야 하는지 여부를 나타냅니다. Storport는 하위 모드 DMA를 지원하지 않으므로 이 멤버를 FALSE로 초기화합니다. 미니포트 드라이버는 이 값을 수정하지 않아야 합니다.

MapBuffers

Storport가 SRB 데이터 버퍼 주소를 시스템 가상 주소에 매핑하는지 여부를 나타냅니다. 미니포트 드라이버는 이 멤버를 다음 값 중 하나로 설정하여 SRB 데이터 버퍼 주소에 대한 매핑을 제어합니다.

값	의미
STOR_MAP_NO_BUFFERS	SRB_FUNCTION_IO_CONTROL 및 SRB_FUNCTION_WMI 대해서만 버퍼를 매핑합니다.
STOR_MAP_ALL_BUFFERS	사용되지 않습니다. 이 값은 STOR_MAP_NON_READ_WRITE_BUFFERS 효과와 동일합니다.
STOR_MAP_NON_READ_WRITE_BUFFERS	읽기 및 쓰기 요청을 제외한 모든 IO에 대한 버퍼를 매핑합니다.
STOR_MAP_ALL_BUFFERS_INCLUDING_READ_WRITE	읽기 및 쓰기 요청을 포함하여 모든 IO에 대한 버퍼를 매핑합니다. 부팅을 지원하는 미니포트는 PAGE_SIZE 읽기 또는 쓰기 요청을 처리해야 합니다. 이러한 읽기 또는 쓰기 요청은 항상 성공적으로 완료되어야 합니다. Storport는 낮은 시스템 메모리 조건에서 버퍼를 매핑하지 못할 수 있습니다. 이 경우 SRB의 DataBuffer 멤버는 NULL이 됩니다.

NeedPhysicalAddresses

TRUE인 경우 미니포트 드라이버는 HBA에서 요구하는 대로 가상 주소를 실제 주소로 변환해야 합니다. Storport는 미니포트 드라이버가 분산/수집 목록을 지원해야 하므로 이 멤버를 TRUE로 초기화합니다. 미니포트는 이 값을 수정하지 않아야 합니다.

TaggedQueuing

TRUE이면 HBA는 SCSI 태그를 사용하여 여러 요청의 큐를 지원합니다. Storport는 미니포트 드라이버가 태그가 지정된 큐를 지원해야 하므로 이 멤버를 TRUE 로 초기화합니다. 미니포트 드라이버는 이 값을 수정하지 않아야 합니다.

AutoRequestSense

TRUE이면 HBA는 자동 요청 센스를 지원합니다. Storport는 미니포트 드라이버가 자동 요청 센스를 지원해야 하므로 이 멤버를 TRUE 로 초기화합니다. 미니포트 드라이버는 이 값을 수정하지 않아야 합니다.

MultipleRequestPerLu

TRUE이면 HBA는 논리 단위당 여러 요청을 지원합니다. Storport는 미니포트 드라이버가 논리 단위에 발급된 여러 요청을 지원해야 하므로 이 멤버를 TRUE 로 초기화합니다. 미니포트 드라이버는 이 값을 수정하지 않아야 합니다.

ReceiveEvent

Storport는 이 멤버를 사용하지 않으며 미니포트 드라이버는 이 멤버를 설정해서는 안됩니다.

RealModeInitialized

Storport는 이 멤버를 사용하지 않으며 미니포트 드라이버는 이 멤버를 설정해서는 안됩니다.

BufferAccessScsiPortControlled

Storport는 이 멤버를 사용하지 않으며 미니포트 드라이버는 이 멤버를 설정해서는 안됩니다.

MaximumNumberOfTargets

어댑터가 제어할 수 있는 대상 주변 장치 수입니다. 기본적으로 이 멤버의 값은 SCSI_MAXIMUM_TARGETS_PER_BUS. 미니포트 드라이버는 HBA에 더 제한된 기능이 있거나 HBA에 확장된 버스 기능이 있음을 나타내는 더 큰 값으로 이 멤버를 더 작은 값으로 다시 설정할 수 있습니다. 이 멤버의 최대값은 255입니다.

SrbType

미니포트 드라이버로 보낼 SRB의 유형입니다. Windows 8 시작해서 사용할 수 있습니다. 다음 값 중 하나로 설정됩니다.

값	의미
SRB_TYPE_SCSI_REQUEST_BLOCK	미니포트 드라이버는 표준 SRB를 받습니다.
SRB_TYPE_STORAGE_REQUEST_BLOCK	미니포트 드라이버는 확장된 SRB를 받습니다.

AddressType

Storport와 미니포트 드라이버 간에 사용되는 주소 유형입니다. Windows 8 시작해서 사용할 수 있습니다. 다음 값으로 설정할 수 있습니다.

값	의미
STORAGE_ADDRESS_TYPE_BTL8	버스, 대상 및 LUN(BTL) 8비트 주소 지정.

ReservedUchars[2]

시스템용으로 예약되어 있습니다(사전 Windows 8).

SlotNumber