SCATTER_GATHER_LIST

typedef struct _SCATTER_GATHER_LIST { ULONG NumberOfElements; UINT_PTR Reserved; SCATTER_GATHER_ELEMENT Elements[]; } SCATTER_GATHER_LIST, *PSCATTER_GATHER_LIST;

SCATTER_GATHER_LIST 구조체는 SCATTER_GATHER_ELEMENT 구조체들의 배열을 지정하는데 각각은 전송된 연속된 범위의 베이스 주소와 길이를 지정한다.

멤버

NumberOfElements

Elements로 버퍼내에 SCATTER_GATHER_ELEMENT 구조체들의 수를 지정한다.

Reserved

예약

Elements

SCATTER_GATHER_ELEMENT 구조체들의 배열을 지정한다. 각 요소는 다음과 같이 정의된다.

typedef struct _SCATTER_GATHER_ELEMENT

{

   PHYSICAL_ADDRESS Address;

   ULONG Length;

   UINT_PTR Reserved;

} SCATTER_GATHER_ELEMENT, *PSCATTER_GATHER_ELEMENT;

이 구조체의 멤버들은 다음의 정보를 포함한다.

Address

전송될 데이터의 연속된 범위의 베이스 물리 주소를 지정한다.

Length

맵된 범위내에 바이트들의 수를 지정한다.

Reserved

예약

주석

버스 마스터 DMA NIC을 관리하고 DMA 초기화하는 동안 NdisMInitializeScatterGatherDma 함수를 호출하는 비직렬화된 혹은 연결 지향 미니포트는 맵된 가상 범위들의 물리 주소들을 얻기 위해 ScatterGatherListPacketInfo의 InfoType으로 NDIS_PER_PACKET_INFO_FROM_PACKET를 호출한다.

버스마스터 DMA NIC을 관리하는 비직렬화된 혹은 연결 지향 미니포트가 ScatterGatherListPacketInfo의 InfoType으로 NDIS_PER_PACKET_INFO_FROM_PACKET를 호출할 때, SCATTER_GATHER_LIST 구조체에 대한 포인터가 전달되어진다. SCATTER_GATHER_LIST 구조체는 SCATTER_GATHER_ELEMENT 구조체들의 배열을 지정하고 각각은 전송될 연속된 범위의 베이스 물리 주소와 길이를 지정한다. 미니포트는 버스마스터 DMA NIC에 대한 이러한 주소와 길이 정보를 제공하고 그래서 NIC은 DMA 전송을 행할 수 있다.

SCATTER_GATHER_LIST 구조체들의 배열에 의해 지정된 맵핑은 미니포트가 NdisMSendComplete 혹은 NdisMCoSendComplete 함수를 호출할 때까지 유효하다.

DMA 초기화하는 동안 NdisMInitializeScatterGatherDma 함수를 호출하는 비직렬화되고 연결 지향 미니포트들은 이러한 식으로 맵된 DMA 버퍼들의 물리 주소들을 얻는다.