NdisMInitializeScatterGatherDma

NDIS_STATUS NdisMInitializeScatterGatherDma( IN NDIS_HANDLE MiniportAdapterHandle, IN BOOLEAN Dma64BitAddresses, IN ULONG MaximumPhysicalMapping );

버스마스터 DMA NIC들을 관리하는 비직렬화된 혹은 연결 지향 미니포트들에 의해 호출되어지는 NdisMInitializeScatterGatherDma 함수는 연속적인 DMA 연산들에서 사용하기 위해 미니포트 초기화하는 동안 시스템 자원들을 초기화한다.

매개변수

MiniportAdapterHandle

MiniportInitialize 함수에 대한 입력 핸들을 지정한다.

Dma64BitAddresses

만약 NIC이 DMA 연산들을 위해 64비트 주소 지정을 사용할 수 있다면은 TRUE를 지정한다. 만약 NIC이 DMA 연산들을 위해 32비트 주소 지정을 사용할 수 있다면은 FALSE를 지정한다.

MaximumPhysicalMapping

하나의 DMA 연산으로 NIC이 전송할 수 있는 최대 바이트 수들을 지정한다.

리턴값

NdisMInitializeScatterGatherDma는 다음과 같은 하나를 리턴할 수 있다.

NDIS_STATUS_SUCCESS

버스마스터 DMA 연산들을 위해 시스템 자원들이 성공적으로 할당되었다.

NDIS_STATUS_RESOURCES

시스템 자원들이 시스템 자원때문에 할당될 수 없다.

NDIS_STATUS_NOT_SUPPORTED

호출자는 NdisMRegisterMiniport함수를 호출할 때 NDIS 5.0 미니포트로서 등록하지 않았고, 호출자는 NdisMSetAttributes 함수 혹은 NdisMSetAttributesEx 함수를 호출할 할 때 NIC이 버스마스터 DMA 장치라고 지정하지 않았고, 호출자는 호출자는 비직렬화 혹은 연결지향 미니포트라고 지정하지 않았다. (미니포트는 NdisMSetAttributesEx 함수로 NDIS_ATTRIBUTE_DESERIALIZE 플래그를 설정함으로써 비직렬화라고 알린다. 미니포트는 NdisMRegisterMiniport 함수로 연결 지향 함수들을 등록한다.)

주석

버스 마스터 DMA NIC을 관리하는 비직렬화 혹은 연결지향 미니포트는 MiniportInitialize 함수로부터 NdisMInitializeScatterGatherDma 함수를 호출한다. 미니포트는 NdisMSetAttributes 함수 혹은 NdisMSetAttributesEx 함수를 호출한 후 그리고 NdisMAllocateSharedMemory 함수를 호출하기 전에 NdisMInitializeScatterGatherDma 함수를 호출해야 한다.

만약 MiniportInitialize 함수가 NdisMSetAttributes 함수 혹은 NdisMSetAttributesEx 함수를 호출할 때 NIC이 버스마스터라는 것을 지정하지 않는다면은, NdisMInitializeScatterGatherDma 함수는 단지 시스템 자원들을 예약하는 시도를 하는 것 없이 제어를 리턴한다.

NdisMInitializeScatterGatherDma 함수는 단지 32비트 64비트 DMA 주소들을 지원한다. 24비트 DMA 주소들은 지원하지 않는다.

DMA 초기화하는 동안 NdisMInitializeScatterGatherDma 함수를 호출하는 미니포트는 DMA 데이터를 포함하는 버퍼들의 맵된 논리적인 주소 범위들을 얻기 위해 다음과 같은 일들을 한다. : MiniportSend 함수 혹은 Miniport(Co)SendPackets 함수에 전달되는 각 패킷 디스크립터를 위해 미니포트는 ScatterGatherListPacketInfo의 InfoType으로 NDIS_PER_PACKET_INFO_FROM_PACKET 매크로를 호출한다. 미니포트는 NIC이 DMA 전송을 위해 NIC에게 얻은 논리 주소 범위들을 제공한다.

버스마스터 NIC들의 직렬화된 드라이버들은 초기화하는 동안 NdisMInitializeScatterGatherDma 함수를 호출하지 않는다. 그 대신에, 그러한 드라이버들은 NdisMAllocateMapRegisters 함수를 호출한다. DMA 데이터를 포함하는 버퍼들의 맵된 논리 주소 범위들을 얻기 위해, 그러한 드라이버들은 NdisQueryPacket 매크로 함수와 NdisMStartBufferPhysicalMapping 함수를 호출한다.

NdisMInitializeScatterGatherDma의 호출자들은 IRQL PASSIVE_LEVEL에서 실행한다.