ScsiPortSetBusDataByOffset 함수(srb.h)

아티클
02/07/2025

ScsiPortSetBusDataByOffset 루틴은 게시된 표준 인터페이스를 사용하여 동적으로 구성 가능한 I/O 버스의 어댑터에 대한 버스 구성 데이터를 설정합니다.

참고 SCSI 포트 드라이버 및 SCSI 미니포트 드라이버 모델은 나중에 변경되거나 사용할 수 없습니다. 대신 Storport 드라이버 사용하고 storport 미니포트 드라이버 모델을 것이 좋습니다.

통사론

SCSIPORT_API ULONG ScsiPortSetBusDataByOffset(
  [in] PVOID DeviceExtension,
  [in] ULONG BusDataType,
  [in] ULONG SystemIoBusNumber,
  [in] ULONG SlotNumber,
  [in] PVOID Buffer,
  [in] ULONG Offset,
  [in] ULONG Length
);

매개 변수

[in] DeviceExtension

미니포트 드라이버의 디바이스 확장에 대한 포인터입니다.

[in] BusDataType

설정할 버스 데이터의 형식을 지정하는 BUS_DATA_TYPE 형식의 값을 포함합니다. 현재 해당 값은 PCIConfiguration 수 있습니다. 그러나 향후 추가 유형의 표준화되고 동적으로 구성 가능한 버스가 지원될 예정입니다. 지원되는 버스 유형의 상한은 항상 MaximumBusDataType .

[in] SystemIoBusNumber

HBA가 연결된 I/O 버스의 시스템 할당 번호를 지정합니다. 미니포트 드라이버의 HwScsiFindAdapter 루틴은 입력 PORT_CONFIGURATION_INFORMATION SystemIoBusNumber 멤버에서 이 값을 가져옵니다.

[in] SlotNumber

HBA의 논리적 슬롯 번호를 지정합니다.

PCIConfigurationBusDataType지정되면 이 매개 변수를 PCI_SLOT_NUMBER 형식 값으로 지정해야 합니다.

[in] Buffer

BusDataType관련된 구성 정보가 있는 호출자 제공 스토리지 영역에 대한 포인터입니다.

PCIConfiguration 지정하면 버퍼에 지정된 SlotNumber대한 PCI_COMMON_CONFIG 정보 중 일부 또는 전부가 포함됩니다. 지정한 오프셋 및 길이는 제공된 정보의 양을 결정할 있습니다.

[in] Offset

호출자가 제공한 구성 값이 시작되는 PCI_COMMON_CONFIG 구조 내에서 바이트 오프셋을 지정합니다. 미니포트 드라이버는 PCI_COMMON_HDR_LENGTH 사용하여 PCI_COMMON_CONFIG 디바이스별 영역의 오프셋을 지정할 수 있습니다.

[in] Length

Buffer스토리지 영역의 바이트 수를 지정합니다.

반환 값

ScsiPortSetBusDataByOffset 지정된 slotNumber 대해 성공적으로 설정된 데이터 바이트 수를 반환합니다. 지정된 BusDataType 현재 플랫폼에 유효하지 않거나 제공된 정보가 잘못된 경우 ScsiPortSetBusDataByOffset 0을 반환합니다.

발언

PCI 버스에 HBA의 미니 포트 드라이버는 드문 상황이나 특정 드라이버의 HBA의 특성이 이러한 호출을 필요로하지 않는 한 ScsiPortSetBusDataByOffset을 호출하지 않습니다. 예를 들어 미니포트 드라이버는 ScsiPortSetBusDataByOffset 호출하여 HBA가 초기화 중에 대상 중단을 알리는 경우 PCI 상태 레지스터에서 비트를 지우거나 HBA에 대한 디바이스별 구성 데이터를 설정할 수 있습니다.

ScsiPortSetBusDataByOffset 컨트롤 형식이 scsiSetRunningConfig 경우 미니포트 드라이버의 HwScsiFindAdapter 루틴 또는 HwScsiAdapterControl에서만 호출할 수 있습니다.