NDIS_GET_PACKET_STATUS
NDIS_STATUS
NDIS_GET_PACKET_STATUS(
IN PNDIS_PACKET Packet
);
|
NDIS_GET_PACKET_STATUS함수는 주어진 패킷 디스크립터와 관련된 OOB블럭으로부터 상태 값을 리턴한다.
매개변수
- Packet
- 패킷 디스크립터의 포인터.
리턴값
NDIS_GET_PACKET_STATUS함수는 주어진 패킷 디스크립터와 관련된 NDIS_PACKET_OOB_DATA블럭내의 현재 설정된 상태값을 리턴하고 일반적으로 다음중 하나이다.:
- NDIS_STATUS_SUCCESS
- 만약 이것이 미니포트의 NdisMIndicateReceivePacket함수의 호출로 부터의 리턴에 설정이면, 미니포트는 다음의 소유권을 다시 얻는다.:
- 패킷 디스크립터
- 관련된 OOB데이타 블럭과 이 블럭내의 지정된 미디엄 의존 정보
- 미니포트가 막 인디케이트한 패킷과 체인돈 버퍼디스크립터에의해 맵된 모든 버퍼.
미니포트 드라이버는 이러한 디스크립터들, OOB블럭, 미디엄 지정 정보 버퍼를 준비할수 있다. 순차적인 수신 인디케이트에서의 재사용을위해, 닉 드라이버라면, 리턴된 버퍼 디스크립터들에의해 맵된 닉의 수신 버퍼들내의 새로운 데이타를 수신할수 있다.
- NDIS_STATUS_PENDING
- 만약 이것이 NdisMIndicateReceivePacket함수로 부터 리턴된 설정이면, 프로토콜은 다음의 소유권을 유지한다.:
- 패킷 디스크립터
- 관련된 OOB블럭과 이 블럭내의 어떤 미디엄 지정 정보 버퍼의 소유권
- 미니포트가 방금 인디케이트한 패킷과 체인된 버퍼 디스크립터들에의해 맵된 모든 버퍼들.
패킷 디스크립터가 인디케이트한 드라이버의 MiniportReturnPacket함수에게 리턴될때까지 패킷 디스크립터로 지정된 어떤 버퍼에 접근하지 않는다.
- NDIS_STATUS_RESOURCES
- 이것이 설정되면, 연결지향 프로토콜 드라이버의 ProtocolCoReceivePacket함수는 닉 드라이버 할당 패킷 리소스들을 유지하기보다는 즉시 패킷 데이타를 복사해야만 한다.
주석
수신을 상위 레벨 드라이버에게 올리는 직렬화된 드라이버들(미니포트 혹은 인터미디엇 드라이버)은 이 메크로를 사용한다. 연결지향 프로토콜들은 그들이 인디케이트된 패킷의 리소스를 소유해야하는지 혹은 그들이 패킷이 인디케이트한 하위 드라이버에게리턴되기전에 즉시 패킷 데이타를 복사해야만 하는지를 결정하기 위해 ProtocolCoReceivePacket함수로 부터 이 매크로를 호출한다.
비 직렬화된 드라이버와 연결지향 드라이버들은 이 메크로를 사용해서는 않된다. 그런 드라이버들은 패킷의 상태를 NDIS_STATUS_RESOURCES로 설정하지않는 패킷을 상위로 올릴때, NDIS는 항상 드라이버의 MiniportReturnPacket함수에게 패킷을 리턴한다. 그런 드라이버가 패킷의 상태를 NDIS_STATUS_RESOURCES로 설정한 패킷을 상위로 올릴때, NDIS는 항상 NdisM(Co)IndicateReceivePacket함수로 부터의 리턴에 절대적으로 그 패킷을 리턴한다. 간단히 말해, NDIS가 그런 드라이버에게 패킷을 리턴할때 -NdisM(Co)IndicateReceivePacket함수로부터 리턴되거나 혹은 드라이버의 MiniportReturnPacket함수에게- 리턴된 패킷과 모든 관련된 리소스들은 드라이버에게 속한다. 그 드라이버는 패킷의 상태가 NDIS_STATUS_RESOURCES인지 NdisM(Co)IndicateReceivePacket함수의 리턴에 상위로 올려 알고 있는 각 수신된 패킷의 상태를 저장해야만 한다.
프로토콜 드라이버는 NdisSendPackets 혹은 NdisSend함수로 부터 관련된 리턴된 OOB데이타 블럭내의 상태 값을 결코 테스트 하지 않는다. ProtocolSendComplete함수가 패킷 디스크립터로 호출 될때까지, NDIS혹은 하위 드라이버는 패킷 디스크립터의 소유권과 관련되 OOB블록과 이 블럭내에 지정된 어떤 버퍼들, 그리고 패킷 디스크립터와 체인된 버퍼디스크립터에의해 맵된 모든 버퍼의 소유권을 유지한다.
NDIS_GET_PACKET_STATUS함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작한다.
|