NdisAllocatePacket

VOID NdisAllocatePacket( OUT PNDIS_STATUS Status, OUT PNDIS_PACKET *Packet, IN NDIS_HANDLE PoolHandle );

NdisAllocatePacket은 패킷 디스크립터을 할당하고 초기화한다.

매개변수

Status

이 함수는 요구에 대한 마지막 상태를 리턴하는 호출자 제공 변수를 가리킨다. 다음과 같은 값이 올 수 있다.

NDIS_STATUS_SUCCESS

호출자는 Packet에 리턴된 패킷 디스크립터를 사용할 수 있다.

NDIS_STATUS_RESOURCES

현재 패킷 풀(pool)를 위한 프리 리스트(free list)가 이용할 수 있는 엔트리 리스트들이 없다. 다음의 NdisFreePacket에 대한 호출은 프리 리스트(free list)에 대한 제공된 엔트리를 리턴할 것이다.

Packet

이 함수는 할당된 패킷 디스크립터에 대한 포인터를 리턴하는 호출자 제공 변수를 가리킨다.

PoolHandle

NdisAllocatePacketPool에 대한 앞선(preceding) 호출에 의해 리턴된 핸들을 지정한다.

주석

NDIS 드라이버들은 패킷 풀(pool)로부터 패킷 디스크립터들을 할당해야 한다. 프로토콜 드라이버들은 NdisSend혹은 NdissendPackets에 대한 나중 호출를 위해 한번이나 여러번 NdisAllocatePacket을 호출한다. 미니포트들은 NdisMIndicateReceivePacket에 대한 나붕 호출을 위해 한번 혹은 여러번 NdisAllocatePacket을 호출한다. NDIS 인터미디엇 드라이버들은 들어오는 전송(transfer) 요구들을 다른 NDIS 드라이버들에게 전달하기(passing) 전에 플레쉬(fresh) 패킷 디스크립터들 내에 보내기들(sends) 혹은 리시브(receive) 인디케이션들(indications)을 다시 패키지화(repackage)하기 위해 NdisAllocatePacket을 호출해야 한다.

각 패킷 디스크립터는 결과적으로 그것과 연결된(chained) 하나나 그 이상의 버퍼 디스크립터들을 가지고 있어야 한다. NdisAllocatePacket은 패킷 디스크립터을 0으로 초기화하고 버퍼 체인 포인터를 NULL로 설정한다. 호출자는 보내거나 인디케이트하기 전에 패킷 디스크립터에 대한 패킷 데이터와 맵핑하는 버퍼 디스크립터들을 연결해야 한다. 대부분 NDIS 드라이버들은 NdisAllocateBuffer로 버퍼 디스크립터들을 할당한다.

드라이버들은 NDIS_GET/SET_PACKET_XXX 매크로들 혹은 NDIS_OOB_DATA_FROM_PACKET를 사용하여 패킷 디스크립터들과 관련된 어떤 아웃오브밴드 정보에 접근하거나 설정한다.

NdisAllocatePacket의 호출자는 IRQL <= DISPATCH_LEVEL로 실행한다.