StorPortGetScatterGatherList 함수(storport.h)

아티클
08/07/2023

StorPortGetScatterGatherList 루틴은 지정된 SCSI 요청 블록(SRB)에 대한 연결된 분산/수집 목록을 검색합니다.

구문

STORPORT_API PSTOR_SCATTER_GATHER_LIST StorPortGetScatterGatherList(
  [in] PVOID               HwDeviceExtension,
  [in] PSCSI_REQUEST_BLOCK Srb
);

매개 변수

[in] HwDeviceExtension

하드웨어 디바이스 확장에 대한 포인터입니다. 포트 드라이버가 미니포트 드라이버를 대신하여 할당하고 초기화하는 HBA 스토리지 영역당 입니다. 미니포트 드라이버는 일반적으로 HBA 상태 및 HBA에 대한 매핑된 액세스 범위와 같은 HBA 관련 정보를 이 확장에 저장합니다. 이 영역은 미니포트 드라이버가 StorPortInitialize를 호출한 직후 미니포트에서 사용할 수 있습니다. 포트 드라이버는 디바이스를 제거할 때 이 메모리를 해제합니다.

[in] Srb

분산형 수집 목록을 생성할 SRB에 대한 포인터입니다.

반환 값

StorPortGetScatterGatherList 는 분산/수집 목록에 대한 포인터를 반환합니다.

설명

이 루틴은 Storport 드라이버 라이브러리와 함께 제공됩니다. SCSI 포트 라이브러리에는 병렬 루틴이 제공되지 않습니다.

반환되는 분산/수집 목록에 대한 포인터는 SRB가 완료될 때까지만 유효합니다.

미니포트 드라이버는 StorPortGetScatterGatherList 가 반환하는 분산/수집 목록에 대한 메모리를 해제할 필요가 없습니다.

미니포트 드라이버는 분산/수집 목록을 수정해서는 안됩니다.

Windows 8 Srb 매개 변수는 SCSI_REQUEST_BLOCK 또는 STORAGE_REQUEST_BLOCK 가리킬 수 있습니다. Srb의 함수 필드에 있는 함수 식별자가 SRB_FUNCTION_STORAGE_REQUEST_BLOCK 경우 SRB는 STORAGE_REQUEST_BLOCK 요청 구조입니다.