NDIS_GET_ORIGINAL_PACKET

PNDIS_PACKET NDIS_GET_ORIGINAL_PACKET( IN PNDIS_PACKET Packet );

NDIS_GET_ORIGINAL_PACKET함수는 NDIS 드라이버가 가리키는 층화된 스택의 최하위 레벨 패킷 디스크립터의 포인터를 리턴한다. 드라이보를 호출하는 것은 드라이버 아래 드라이버가 가리켜 지는 패킷 보다 오리지널 패킷으로부터 OOB 데이터 블럭에 접근 해야 한다. 만약 드라이보를 호출하는 것이 층화된 스택의 파트가 아니면, 리턴된 패킷 디스크립터는 드라이버 아래 호출하는 드라이버가 가리켯던 것과 일치 해야 한다.

매개변수

Packet

드라이버 아래 호출하는 드라이버가 가리켜지는 패킷 디스크립터를 가리킨다.

리턴값

NDIS_GET_ORIGINAL_PACKET함수는 NDIS 드라이버가 가리키는 층화된 스택의 최하위 레벨 패킷 디스크립터의 포인터를 리턴하거나,만약 드라이보를 호출하는 것이 층화된 스택의 파트가 아니면, NDIS_GET_ORIGINAL_PACKET함스는 드라이버 아래 호출하는 드라이버가 가리켰던 패킷 디스크립터를 리턴한다.

주석

관행적으로 NDIS_GET_ORIGINAL_PACKET함수에 의해 리턴된 패킷은 드라이버 아래 호출하는 드라이버에의햐 위로 가리켜진 패킷과 같다. 예를 들어, 상위레벨 드라이버로 패킷을 가리키기 위해 드라이버는하위 레벨 드라이보가 위로 가리켜준 받은 패킷을 호출할 수 있다. 드라이버는 NdisGetReceivedPacket 함수를 호출할 수 있다.

NDIS 드라이보의 충화된 스택의 최하위 레벨 드라이버에 의해 위로 가리켜진 패킷의 포인터를 얻기위해, 프로토콜롸 인터미디엇 드라이버는 NDIS_GET_ORIGINAL_PACKET함수를 호출한다. 이 호출에서, 그것들은 받은 패킷의 포인터를 패스한다. 이 호출을 사용하는 것은, 층화된 스택의 각 드라이버는 패킷이 각 층으로 카피되는 것을 요구하는 것 없이 네트웍으로 부터 받은 패킷과 연결된 OOB데이터 블럭에 접근할 수 있다.

이 매크로의 호출자는 어떤 IRQL에서도 실행 될 수 있다.

Example

다음의 코드 예는 회수한 패킷으로 부터 오리지널 패킷을 얻는 것과 드라이버 아래로 부터 받았던 패킷을 받는 것이다.

// Get the original packet, which could be the received packet

// or the packet originating from the lowest-level driver.

// This result is based on the number of layered drivers in the stack.

//



Pkt = NdisGetReceivedPacket(BindingHandle, MacReceiveContext);

OrigPkt = NDIS_GET_ORIGINAL_PACKET(Pkt);