NdisQueryPacket

VOID NdisQueryPacket( IN PNDIS_PACKET Packet, OUT PUINT PhysicalBufferCount OPTIONAL, OUT PUINT BufferCount OPTIONAL, OUT PNDIS_BUFFER *FirstBuffer OPTIONAL, OUT PUINT TotalPacketLength OPTIONAL );

NdisQueryPacket은 주어진 패킷에 대한 정보를 리턴한다.

매개변수

Packet

패킷 디스크립터를 가리킨다.

PhysicalBufferCount

이 함수는 주어진 패킷에 연결된 버퍼 디스크립터들에 의해 맵된 물리breaks의 최대 수를 리턴한느 호출자 제공 변수를 가리킨다.

BufferCount

이 함수는 주어진 패킷에 대해 연결된 버퍼 디스크립터들의 수를 리턴하는 호출자 제공 변수를 가리킨다. 이 매개변수는 NULL이 될 수 있다.

FirstBuffer

이 함수는 주어진 패킷에연결된 버퍼 디스크립터들의 수를 리턴하는 호출자 제공 변수를 가리킨다. 이 매개변수는 NULL이 될 수 있다.

TotalPacketLength

이 함수는 모든 연결된 버퍼 디스크립터들에 의해 맵된 패킷 데이터의 바이트 수를 리턴하는 호출자 제공 변수를 가리킨다. 이 매개변수는 NULL이 될 수 있다.

주석

NdisQueryPacket은 주어진 패킷에 대해 호출자 선택 정보를 리턴한다. 호출자는 적어도 Packet 매개변수에 따라 PhysicalBufferCount, BufferCount, FirstBuffer, TotalPacketLength 포인터들의 적어도 하나를 지정해야 한다. 호출자는 모든 매개변수들을 위해 외연적으로 포인터들을 지정할 수 있다.

외연적으로 PhysicalBufferCount 포인터를 지정하는 것은 패킷 디스크립터내에 각 버퍼 디스크립터를 위해 NdisGetBufferPhysicalArraySize에 대한 호출들을 summing 하는 것과 동등하다. 드라이버는 만약 호출이 패킷 디스크립터가 데이터가 없다는 것을 가리키는 0을 리턴하지 않는다면은 체인내에서 어떤 계속된 버퍼 디스크립터들에 대한 포인터들을 검색하는데 필요한 만큼 여러번 NdisGetNextBuffer를 호출할 수 있다.

만약 호출자가 외연적인 BufferCount 포인터를 제공한다면은, NdisQueryPacket은 패킷 체인내에서 버퍼 디스크립터들의 수를 리턴한다. 리턴된 값은 NdisUnchainBufferXxx 함수들의 어떠한 것으로 체인내에 버퍼 디스크립터들을 검색하기 위해 loop 카운터들로 사용되어질 수 있다.

만약 호출자가 외연적인 FirstBuffer 포인터를 제공하지만은 패킷의 버퍼 체인이 빈다면은, NdisQueryPacket은 FirstBuffer은 NULL을 리턴한다. 그렇지 않다면은, 호출자는 패킷을 위해 초기화된 버퍼 디스크립터에 대해 자세한 정보를 얻기 위해 계속해서 NdisQueryBuffer를 사용할 수 있다. 더 빠른 대안으로, 드라이버들은 초기 버퍼 디스크립터에 대한 포인터를 얻기 위해 NdisGetFirstBufferFromPacket 함수를 호출할 수 있다.

만약 호출자가 외연적인 TotalPacketLength 포인터를 제공한다면은, NdisQueryPacket 함수는 주어진 패킷에 연결된 모든 버퍼 디스크립터에 의해 지정된 바이트들의 총 수를 리턴한다.

NdisQueryPacket의 호출자들은 어떤 IRQL에서 실행할 수 있다.