NdisMCompleteDmaTransfer

VOID 

  NdisMCompleteDmaTransfer(

    OUT PNDIS_STATUS  Status,

    IN NDIS_HANDLE  MiniportDmaHandle,

    IN PNDIS_BUFFER  Buffer,

    IN ULONG  Offset,

    IN ULONG  Length,

    IN BOOLEAN  WriteToDevice

    );

NdisMCompleteDmaTransfer는 시스템 DMA 전송 연산을 완성하는 것을 가리킨다. DMA 전송들을 위해 준비중인 시스템 DMA 컨트롤러를 리셋한다.

매개변수

Status
다음과 같은 하나가 될 수 있다. 이 함수가 DMA 전송의 마지막 상태로 리턴하는 호출자 제공 변수를 가리킨다.

NDIS_STATUS_SUCCESS
데이터가 데이터 무결성을 유지하기 위해 장치와 호스트 메모리에 플러쉬와 전송이 되어진다.

NDIS_STATUS_RESOURCES
DMA 컨트롤러는 해제되지만은 데이터 전송은 흩어져 있을 것이다.

MiniportDmaHandle
MiniportInitialize가 NdisMRegisterDmaChannel를 호출할 때 리턴되어지는 핸들을 지정한다.

Buffer
전에 NdisMSetupDmaTransfer에 전달된 버퍼 디스크립터를 가리킨다.

Offset
전송이 시작되는 시점에서 바이트 옵셋을 지정한다. 이 값은 또한 NdisMSetupDmaTransfer로 전달되어진다.

Length
전송의 바이트 수를 지정한다. 이 값은 또한 NdisMSetupDmaTransfer로 전달되어진다.

WriteToDevice
만약 전송이 예를 들어 보내기 연산으로 호스트에서 NIC으로 된다면은 TRUE로 지정된다.

주석

NdisMCompleteDmaTransfer는 전송 데이터가 NIC 메모리내에 존재한다고 여겨지기 전에 WriteToDevice가 TRUE로 설정되어서 호출되어질 것이다. NdisMCompleteDmaTransfer는 전송 데이터가 호스트 메모리로부터 읽을 수 있기 전에 WriteToDevice가 FALSE로 설정되어져서 호출되어질 수 있다.

NdisMCompleteDamTransfer의 호출자들은 IRQL <= DISPATCH_LEVEL에서 실행한다.