NdisMSendResourcesAvailable

VOID NdisMSendResourcesAvailable( IN NDIS_HANDLE MiniportAdapterHandle );

NdisMSendResourcesAvailable 함수는 하나이상의 두드러진 보내기 패킷이 미니포트에서 지연중이라 할지라도 미니포트가 또다른 보내기 리퀘스트를 받아들이기 위한 충분한 내부 자원을 가지고 있음을 NDIS에게 알린다.

매개변수

MiniportAdapterHandle

MiniportInitialize 함수로 입력되는 핸들을 가리킨다.

주석

NDIS 라이브러리는 미니포트를 대신해서 보내기 리퀘스트를 큐에 저장한다. 따라서 미니포트가 NIC의 능력에 의존하여 연산당 몇개의 패킷을 보낼 수 있다고 하더라도 각각의 NIC 드라이버는 한번에 하나의 장치 전송 연산을 처리할 수 있다. NDIS는 각각의 MiniportSendPackets 함수로 들어오는 패킷배열의 복종을 직렬화한다. 그리고 미니포트의 MiniportSend 함수에 대한 패킷의 복종을 직렬화한다. NDIS는 FIFO 순서로 들어오는 보내기 리퀘스트를 큐에 저장한다.

어떤 미니포트는 다음중 하나의 방법으로 그러한 보내기 패킷의 소유권을 얻을 수 있다:

• MiniportSendPackets 함수는 NDIS_SET_PACKET_STATUS를 가지고 NDIS_STATUS_PENDING에 대한 패킷을 위해서 OOB 데이타 블럭의 Status 멤버를 설정한다.
• MiniportSend 함수는 NDIS_STATUS_PENDING을 리턴한다.

그러나 미니포트는 지연된 패킷에 대해 NdisMSendComplete 함수를 호출하기 전에 NDIS가 그 드라이버로 제출하는 하나의 큐를 가지고 있다는 가정하에 드라이버와 NIC이 즉시 또다른 보내기 리퀘스트를 받아들일 수 있다면 미니포트는 NdisMSendResourcesAvailable 함수를 호출할 수 있다. 그러한 호출은 높은 능력을 가진 NIC의 드라이버로 하여금 한번에 많은 데이타를 보냄으로써 네트웍상으로 전송을 활용하도록한다.

NdisMSendResourcesAvailable 함수는 주어진 패킷을 위한 NDIS_STATUS_PENDING의 리턴과 패킷을 가지고 미니포트의 NdisMSendComplete 함수 호출사이의 윈도우에서만 호출될 수 있다.

미니포트가 MiniportSendPackets나 MiniportSend 함수로부터 특정 패킷에 대해서 NDIS_STATUS_PENDING을 제외한 다른 값을 리턴한다면 미니포트는 NdisMSendResourcesAvailable 함수 아니면 NdisMSendComplete 함수를 호출해야한다. NIC 드라이버가 NDIS_STATUS_PENDING 이외의 다른 값을 리턴하는 어떤 보내기 패킷은 MiniportSendPackets 혹은 MiniportSend 함수의 리턴에서 미니포트에 의해서 접근이 불가능하도록 고려되어야한다.

WAN 미니포트는 NdisMSendResourcesAvailable 함수를 호출할 수 없다.

NdisMSendResourcesAvailable 함수의 호출자는 IRQL DISPATCH_LEVEL에서 실행한다.