NDIS_OOB_DATA_FROM_PACKET

PNDIS_PACKET_OOB_DATA NDIS_OOB_DATA_FROM_PACKET( IN PNDIS_PACKET _Packet );

NDIS_OOB_DATA_FROM_PACKET 함수는 주어진 패킷 디스크립터와 연관된 OOB 데이타 블럭에 대한 포인터를 리턴한다.

매개변수

Packet

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

리턴값

NDIS_OOB_DATA_FROM_PACKET 함수는 주어진 패킷 디스크립터와 연관된 OOB 데이타 블럭에 대한 포인터를 리턴한다. 혹은 패킷에 대한 OOB 정보가 없다면 NULL을 리턴한다.

주석

인디케이션을 위해서 할당한 패킷 디스크립터를 가지고 OOB 정보를 제공하는 하위 레벨 NDIS 드라이버는 드라이버 할당 패킷 디스크립터와 연관된 OOB 블럭으로의 접근을 얻기 위해서 NDIS_OOB_DATA_FROM_PACKET 함수를 사용할 수 있다. 그러한 드라이버는 리시브 패킷을 인디케이트하기 전에 OOB 정보를 설정한다.

예를들어 NDIS 인터미디엇 드라이버는 바인딩된 프로토콜로 인디케이션을 전달하기 전에 NdisMoveMemory 함수를 가지고 리시브된 패킷에서 초기화된 패킷 디스크립터안으로 OOB 정보를 복사한다. 이 상황에서 인터미디엇 드라이버는 Source와 Destination 포인터에 대해서는 NDIS_OOB_DATA_FROM_PACKET 함수에 의해서 리턴된 포인터가지고 Length에 대해서는 sizeof(NDIS_PACKET_OOB_DATA)를 가지고 NdisMoveMemory 함수를 호출한다.

또한 하위 레벨 NDIS 드라이버는 인디케이트된 패킷의 상태가 NDIS_STATUS_SUCCESS를 가지고 NdisMIndicateReceivePacket 함수로부터 리턴될 때 이 매크로를 사용한다. 그리고 MiniportReturnPacket 함수가 재사용을 위해서 초기화되는 패킷 디스크립터를 가지고 호출될 때 사용한다.이 상황에서 드라이버는 패킷 디스크립터와 연관된 OOB 블럭을 클리어하기 위해서 sizeof(NDIS_PACKET_OOB_DATA)와 NDIS_OOB_DATA_FROM_PACKET 함수에 의해서 리턴된 포인터를 가지고 NdisZeroMemory 함수를 호출할 수 있다. 선택적으로 그러한 드라이버는 리턴된 패킷 디스크립터를 가지고 순차적인 인디케이션을 위해서 OOB 블럭안에 특정 멤버를 재초기화하기 위해서 적절한 NDIS_SET_PACKET_XXX 매크로를 사용할 수 있다.

패킷 디스크립터가 ProtocolSendComplete 함수에서 리턴될 때 보내기를 서술하기 위해서 그들이 할당한 패킷 디스크립터와 연관된 OOB 블럭을 재초기화하기 위해서 상위 레벨 NDIS 드라이버는 NDIS_OOB_DATA_FROM_PACKET 함수를 사용할 수 있다. 결국 그러한 프로토콜의 하부에 있는 드라이버는 들어오는 보내기 패킷에 대한 OOB 블럭을 읽기 위해서 NDIS_OOB_DATA_FROM_PACKET 함수를 사용한다.

드라이버는 패킷 디스크립터와 연관된 OOB 블럭을 클리어하기 위한 시도에서 NdisZeroMemory 함수로 패킷 디스크립터를 전달해서는 안된다. 이것을 행한다면 주어진 패킷 디스크립터를 파괴하고 순차적인 인디케이션과 보내기를 쓸모없게 한다. 그리고 메모리 부적을 야기한다. 드라이버는 드라이버 할당 패킷 디스크립터와 연관된 OOB 데이타 블럭을 0으로 재초기화하기 위해서 NDIS_OOB_DATA_FROM_PACKET 함수에 의해서 리턴된 포인터를 전달해야한다.