NdisReinitializePacket

VOID NdisReinitializePacket( IN OUT PNDIS_PACKET Packet );

NdisReinitializePacket 함수는 주어진 패킷으로부터 체인화된 버퍼들을 제거하고 재사용을 위해서 그것을 다시 초기화한다.

매개변수

Packet

호출자에 의해서 할당된 패킷 디스크립터를 가리킨다.

주석

NdisReinitializePacket 함수는 패킷 디스크립터를 다시 초기화한다. 그래서 MiniportReserved와 ProtocolReserved 배열들은 모두 0으로 초기화되고 버퍼 체인의 헤드도 NULL로 설정된다.

드라이버는 그 드라이버에 의해서 할당된 패킷 디스크립터를 가지고서만 NdisReinitializePacket 함수를 호출할 수 있다. 예를들어 MiniportReturnPacket 함수는 순차적인 리시브 인디케이션에서 드라이버 할당 패킷 사용을 준비하기 위해 NdisReinitializePacket 함수를 호출하는 게 더 낫다.

NdisReinitializePacket 함수를 호출하기 전에 드라이버는 패킷에 체인된 모든 버퍼 디스크립터를 저장하거나 자원해제를 위해서 필요한 만큼 NdisFreeBuffer나 NdisUnchainBufferAtXxx 함수를 호출해야한다. 반면에 NdisReinitializePacket 함수의 호출은 메모리 부족을 야기한다: 버퍼 디스크립터 체인과 연관된 모든 메모리는 시스템이 재부팅 될 때까지 NDIS나 드라이버에 의해서 사용될 수 없다.

드라이버는 버퍼 디스크립터가 주어진 패킷에 얼마나 많이 체인되었는지를 결정하기위해서 NdisQueryPacket 함수를 호출할 수 있다. 그러므로 NdisFreeBuffer나 NdisUnchainBufferAtXxx 함수는 요구된 만큼 많이 호출된다. 드라이버는 NdisFreeBuffer 함수로 전해지는 각각의 버퍼 디스크립터의 포인터를 얻기위해 NdisGetNextBuffer 함수를 호출한다.

NdisReinitializePacket 함수 호출은 패킷 디스크립터와 연관된 NDIS_PACKET_OOB_DATA 블럭 상에서는 효과적이지 않다. 이 블럭의 재사용을 준비하기위해 드라이버는 NDIS_OOB_DATA_FROM_PACKET에 의해서 리턴된 포인터를 가지고 NdisZeroMemory 함수를 호출하거나 적절한 NDIS_SET_PACKET_XXX 매크로를 가지고 관련 멤버들을 리셋할 수 있다.

NdisReinitializePacket 함수의 호출자는 어떤 IRQL에서도 실행할 수 있다.