NDIS_GET_PACKET_MEDIA_SPECIFIC_INFO

VOID

  NDIS_GET_PACKET_MEDIA_SPECIFIC_INFO(

    IN PNDIS_PACKET  Packet,

    IN PPVOID  pMediaSpecificInfo,

    IN PUINT  pSizeMediaSpecificInfo

    );

NDIS_GET_PACKET_MEDIA_SPECIFIC_INFO는 MediaSpecificInformation함수의 포인터와 주어진 패킷 디스크립터와 연결된 OOB 데이터로 부터 SizeMediaSpecificInfo함수 값을 리턴한다.

매개변수

Packet
패킷 디스크립터의 포인터.

pMediaSpecificInfo
이 매크로가 MediaSpecificInformation함수의 포인터를 셋하는 호출자 제공 가변의 포인터. 리턴된 어드레스는 호출자가 아무 특정 net 패킷의 인디케이트되는 것과 연결 되거나 보내지기 위한 버퍼화된 패킷 우선권 같은 OOB 데이터에 접근할 수 있게 해준다.

pSizeMediaSpecificInfo
이 메크로가 SizeMediaSpecificInfo함수 값을 셋하기 위한 호출자 제공 가변의 포인터이고, MediaSpecificInformation함수에서 버퍼의 바이트 사이즈를 명시한다.

주석

만약 주어진 패킷 디스크립터와 연결된 NDIS_PACKET_OOB_DATA블럭의 미디엄 특정 정보가 없으면 NDIS_GET_PACKET_MEDIA_SPECIFIC_INFO는 pMediaSpecificInfo에서 NULL포인터와 pSizeMediaSpecificInfo에서 0을 리턴한다.

미디엄에 의존해라. NIC 미니프트는 그들의 멤버를 리시브의 인디케이션을 위해 할당된 패킷 디스크립터와 연결된 OOB 데이터 블럭안의 NDIS_SET_PACKET_MEDIA_SPECIFIC_INFO와 함께 셋한다.

프로토콜이 보내기를 위해 할당된 패킷 디스크립터와 연결된 OOB 데이터 블럭안의 MediaSpecificInformation와 SizeMediaSpecificInfo를 셋하는 바인드된 아래단의 드라이버의 미디엄에 의존해라.

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

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

  • 프로토콜 드라이버는 보내기를 위해 셋업된, 아니면 페킷 디스크립터가 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_GET_PACKET_MEDIA_SPECIFIC_INFO의 호출자는 IRQL <= DISPATCH_LEVEL에서 실행한다.