NdisMSetupDmaTransfer
VOID
NdisMSetupDmaTransfer(
OUT PNDIS_STATUS Status,
IN NDIS_HANDLE MiniportDmaHandle,
IN PNDIS_BUFFER Buffer,
IN ULONG Offset,
IN ULONG Length,
IN BOOLEAN WriteToDevice
);
|
NdisMSetupDmaTransfer 함수는 DMA 전송을 위해서 호스트 DMA 컨트롤러를 설정한다.
매개변수
- Status
- 다음 중 하나가 될 수 있는 리퀘스트의 상태를 리턴하는 이 함수의 호출자 제공 변수를 가리킨다:
- NDIS_STATUS_SUCCESS
- DMA 컨트롤러가 데이타 무결성을 유지하기 위해서 장치로부터 초기화한 명시된 데이타를 전송하기 위해서 설정됐다.
- NDIS_STATUS_RESOURCES
- 전송을 위해서 DMA 컨트롤러를 설정하는 시도가 실패했다. 왜냐하면 MiniportDmaHandle에 의해서 지시되는 채널이 현재 데이타 전송에 사용중이거나 주어진 Length가 유효하지 않기 때문이다.
- MiniportDmaHandle
- 초기화 동안에 NdisMRegisterDmaChannel 함수에 의해서 리턴된 핸들을 서술한다.
- Buffer
- 데이타가 전송될 호스트 메모리의 범위를 매핑하는 버퍼 디스크립터를 가리킨다.
- Offset
- 전송이 시작될 때 맵된 버퍼안의 바이트 옵셋을 서술한다. 0은 전송이 Buffer에 명시된 범위의 처음 바이트에서 시작해야함을 알린다.
- Length
- 전송되는 데이타의 바이트 수를 서술한다. Offset과 Length에 의해서 명시된 범위는 Buffer에 명시된 적절한 서브 범위이어야한다.
- WriteToDevice
NIC을 통해서 시스템으로부터 아웃바운드 전송을 위해서 TRUE를 서술한다.
주석
슬레이브 DMA NIC의 드라이버는 WriteToDevice가 TRUE로 설정된 것에 대해서 보내기 리퀘스트에 대한 응답으로 NdisMSetupDmaTransfer 함수를 호출한다. 그들이 NIC으로부터 호스트 메모리로 리시브된 데이타를 전송할 때 WriteToDevice를 FALSE로 설정한다.
NdisMSetupDmaTransfer 함수의 호출자는 전송 타겟이 되고 호스트에서 NIC으로의 다운로드 연산에 대한 데이타를 포함하는 호스트 메모리 범위에 매핑된 버퍼 디스크립터를 제공한다. NIC의 DMA 억제를 만족시키는 사이즈로 전송을 서술하기 위해서 호출자는 필요하다면 Offset과 Length 매개변수를 가지고 전송되도록 서브 범위를 설정할 수 있다.
호출자는 WriteToDevice가 FALSE일 때 NIC으로부터 전송될 리시브 데이타의 호스트 범위를 서술하는 버퍼 디스크립터를 제공해야한다. 그렇지 않으면 Buffer의 버퍼 디스크립터는 NIC 드라이버의 MiniportSend나 MiniportSendPackets 함수로 입력되는 패킷 디스크립터에 체인화된다.
길이가 256K 보다 작은 보내기 리퀘스트처럼 작은 전송 리퀘스트에 대한 퍼포먼스를 향상시키기 위해서 미니포트는 내부의 단계적인 버퍼 안으로 패킷 데이타를 복사할 수 있고 그 버퍼를 매핑하는 드라이버 할당 버퍼 디스크립터를 NdisMSetupDmaTransfer 함수로 전달한다.
NdisMSetupDmaTransfer 함수로부터의 리턴에서 호스트 DMA 컨트롤러는 전송을 위해서 프로그램되었다. 그리고나서 미니포트는 전송 연산을 위해서 NIC을 프로그램한다.
전송이 완료됐을 때 미니포트는 NdisMCompleteDmaTransfer 함수를 호출해야한다.
NdisMSetupDmaTransfer 함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행한다.
|