NDIS_SET_PACKET_MEDIA_SPECIFIC_INFO

NDIS_SET_PACKET_MEDIA_SPECIFIC_INFO(

    IN PNDIS_PACKET  Packet,

    IN PVOID  MediaSpecificInfo,

    IN UINT  SizeMediaSpecificInfo

    );

NDIS_SET_PACKET_MEDIA_SPECIFIC_INFO는 주어진 패킷 디스크립터와 연결된 OOB 데이터 블럭의 MediaSpecificInformation 포인터와 SizeMediaSpecificInfo 값을 셋한다.

매개변수

Packet
드라이버 할당 패킷 디스크립터를 가리킨다.

MediaSpecificInfo
호출자 제공의 주어진 패킷 디스크립터와 함께 NDIS_PACKET_OOB_DATA 블럭의 MediaSpecificInformation 맴버를 셋하기위한 패킷 우선권 같은,미디엄 특정 정보를 포함하는 버퍼를 위한 포인터를 명시한다.

SizeMediaSpecificInfo
MediaSpecificInformation에서 제공된 정보의 바이트 수를 명시한다.이 파라미터는 0이될 수 없다.

주석

아래단 드라이버가 리시브 인다케이션을 위해 할당된 패킷 디스크립터에 연결된 OOB 데이터 블럭안의 NDIS_SET_PACKET_MEDIA_SPECIFIC_INFO와 함께 그 맴버들을 셋해야 하는 미디엄에 의존한다. 바인드된 프로토콕 이 인디케이션과 함께 호출됬을 때, 이것은 제공된 정보에 접근하기 위해 NDIS_GET_PACKET_MEDIA_SPECIFIC_INFO를 사용한다.

보내기를 위해 할당된 패킷 디스크립터와 연결된 OOB 블럭안의 MediaSpecificInformation과 SizeMediaSpecificInfo를 셋하는 프로토콜과 바인드된 아래단의 드라이버에 의존하다. 아래단의 드라이버는 제공된 정보에 접근하기 위해 NDIS_GET_PACKET_MEDIA_SPECIFIC_INFO를 사용한다.

상위레벨 프로토콜이 리시브 인디케이션을 소모하는 동안 또는 하위레벨 미니포트가 보내기를 처리하는 동안의경우, 드라이보는 MediaSpecificInformation의 버퍼에 배타적인 접근을 한다. 이 제한은 다음을 암시한다.

  • 미니포트는 OOB와 연결된 상태 맴버에서 셋된 NDIS_STATUS_PENDING이면 NdisMIndicateReceivePacket이 제어권을 리턴할 때 OOB 정보와 함께 셋업된 버퍼에 접근할 수 없다. 드라아버는 패킷배열안의 각 패킷이 단지 상태 set이 인디케이트 되는지 NDIS_STATUS_SUCCESS를 리턴받는지를 결정하기 위해 NDIS_GET_PACKET_STATUS를 사용할 수 있다.

  • 프로토콜 드라이버는 보내기를 휘해 OOB정보와 함께 셋업된 버퍼에 접근할 수 없다. 아니면 프로토콜 드라이버는 보내기를 위해 셋업된, 아니면 페킷 디스크립터가 ProtocolSendComplete함수로 리턴될 때까지 NdisSendPackets함수나 NdisSend함수에게 패스되는 패킷 디스크립터와 연결된 OOB 데이터 안의 다른 어떤 것도 다시 미디엄 특정 정보버퍼에 접근할 수 없다.

    왜냐 하면 MiniportSend 함수가 NDIS_STATUS_RESOURCES를 리턴 받거나 MiniportSendPackets 함수가 재전송 배열안의 패킷을 상태에 대해 NDIS_STATUS_RESOURCES를 셋하면 NDIS는 보내기 패킷을 큐하고 그것들을 다시 시도하기 때문이다. 보내기(배열)안의 각 패킷의 마지막 상태는 패킷 ProtocolSendComplete함수로 리턴 됬을때 까지는 사라지지 쉽다.

프로토콜 드라이버는 ProtocolReceive함수가 인디케이션을 받았을 때 패킷 디스크립터와 함께 NDIS_PACKET_OOB_DATA블럭으로 부터 이 정보를 포함하기 위해 NDIS_GET_ORIGINAL_PACKET에 의해 다음의 NdisGetReceivedPacket함수를 호출할 수 있다. 어째든, 프로토콜이 인티케이션과 함께 OOB 정보가 제공되지 않는 아래단 드라이버에 바인드 되어 있으면 그 호출들은 과잉이다.

NDIS_SET_PACKET_MEDIA_SPECIFIC_INFO의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행한다.