NdisMRegisterDmaChannel

NDIS_STATUS NdisMRegisterDmaChannel( OUT PNDIS_HANDLE MiniportDmaHandle, IN NDIS_HANDLE MiniportAdapterHandle, IN UINT DmaChannel, IN BOOLEAN Dma32BitAddresses, IN PNDIS_DMA_DESCRIPTION DmaDescription, IN ULONG MaximumLength );

NdisMRegisterDmaChannel 함수는 슬레이브 NIC 혹은 ISA 버스마스터 NIC에서 DMA 연산을 위해서 초기화동안에 시스템 DMA 컨트롤러 채널을 요구한다.

매개변수

MiniportDmaHandle

NdisMXxx 시스템 DMA 함수의 순차적인 호출에서 미니포트가 사용한 핸들을 리턴하는 이 함수의 호출자 제공 변수를 가리킨다.

MiniportAdapterHandle

MiniportInitialize 함수로 입력되는 핸들을 서술한다.

DmaChannel

무시된다. 있다면 DmaDescription에 DMA 채널을 설정해라.

Dma32BitAddresses

NIC이 32 주소 라인이라면 TRUE를 서술한다.

DmaDescription

호출자에 의해서 채워진 NDIS_DMA_DESCRIPTION 구조체를 가리킨다. 이 구조체는 다음과 같이 정의된다:

typedef struct _NDIS_DMA_DESCRIPTION {

    BOOLEAN DemandMode;

    BOOLEAN AutoInitialize;

    BOOLEAN DmaChannelSpecified;

    DMA_WIDTH DmaWidth;

    DMA_SPEED DmaSpeed;

    ULONG DmaPort;

    ULONG DmaChannel;

} NDIS_DMA_DESCRIPTION, *PNDIS_DMA_DESCRIPTION;

드라이버는 다음의 멤버를 채우기 전에 0으로 이 구조체를 초기화해야한다:

DemandMode

슬레이브 NIC이 시스템 DMA 컨트롤러의 요구 모드를 사용한다면 TRUE를 서술한다.

AutoInitialize

슬레이브 NIC이 시스템 DMA 컨트롤러의 자동초기화 모드를 사용한다면 TRUE를 서술한다.

DmaChannelSpecified

DmaChannel이 NIC에 의해서 사용된 시스템 DMA 컨트롤러 채널의 버스 관련 값으로 설정됐다면 TRUE를 서술한다.

DmaWidth

DMA 연산에 대한 전송 넓이를 서술한다. Width8Bits, Width16Bits, 혹은 Width32Bits 중에 하나이다.

DmaSpeed

Compatible, TypeA, TypeB, 혹은 TypeC 중에 하나를 서술한다.

DmaPort

더이상 지원되지 않는 MCA 버스를 언급한다. 이 멤버는 0이어야한다.

DmaChannel

NIC에 의해서 사용된 시스템 DMA 컨트롤러 채널의 버스 관련 수를 서술한다.

MaximumLength

NIC이 하나의 DMA 연산에서 전송할 수 있는 최대의 바이트 수를 서술한다. NIC이 무제한의 전송 능력을 가진다면 이 매개변수를 -1로 설정해라.

리턴값

NdisMRegisterDmaChannel 함수는 다음 상태값 중에 하나를 리턴한다:

NDIS_STATUS_SUCCESS

NDIS는 호출자의 NIC을 위해서 레지스트리에서 명시된 DMA 채널을 요구하고 미니포트에 의한 순차적인 DMA 연산을 위해서 필요한 자원을 설정한다.

NDIS_STATUS_RESOURCE_CONFLICT

다른 드라이버가 장치에 대해서 그 채널을 이미 요구했기 때문에 레지스트리에서 DMA 채널을 요구하는 시도가 실패했다. 이것이 발생한다면 NdisMRegisterDmaChannel 함수는 에러를 저장한다.

NDIS_STATUS_RESOURCES

NDIS는 이 NIC 드라이버에 의한 DMA 연산을 지원할 필요가 있는 시스템 자원을 할당하지 않았다.

NDIS_STATUS_FAILURE

버스 타입 혹은 버스 넘버가 범위 밖이거나 드라이버가 ISA가 아닌 다른 I/O 버스 상에서 NIC을 버스마스터로 선언했다.

주석

슬레이브 DMA NIC의 드라이버는 순차적인 DMA 연산에 대한 시스템 자원을 예약하기 위해서 MiniportInitialize 함수로부터 NdisMRegisterDmaChannel 함수를 호출해야한다.

또한 ISA 버스마스터 NIC의 드라이버는 레지스트리에서 NIC에 대한 시스템 DMA 컨트롤러를 요구하기 위해서 MiniportInitialize 함수로부터 NdisMRegisterDmaChannel 함수를 호출해야한다.

MiniportInitialize 함수는 NdisMRegisterDmaChannel 함수를 호출하기 전에 NdisMSetAttributes나 NdisMSetAttributesEx 함수를 호출해야한다.

MiniportInitialize 함수는 레지스트리나 버스 타입 특정 NdisXxx 구성함수를 호출하므로써 NdisMRegisterDmaChannel 함수로 전달되는 버스 관련 값을 얻는다.

그러한 드라이버가 장치가 필요로하는 시스템 DMA 자원을 할당할 수 없다면 MiniportInitialize 함수는 NIC을 위해서 이미 할당한 모든 자원을 해제해야한다. 그러면 그 NIC에 대한 초기화는 실패한다.

NdisMRegisterDmaChannel 함수의 호출자는 IRQL PASSIVE_LEVEL에서 실행한다.