NdisSetPacketFlags

VOID NdisSetPacketFlags( IN PNDIS_PACKET Packet, IN UINT Flags );

NdisSetPacketFlags 함수는 주어진 패킷 디스크립터의 플래그 안에 호출자 결정, 그리고 미디업 특정 정보를 설정한다.

매개변수

Packet

플래그가 설정되는 패킷 디스크립터를 가리킨다.

Flags

NDIS에 의해 사용되기 위해서 예약된 패킷 디스크립터의 private 부분에 있는 플래그 안에 설정되는 값을 서술한다.

프로토콜이 바인딩을 설정하기 위해서 NdisOpenAdapter 함수를 호출했을 때 프로토콜에 대해서 이 값의 포맷은 하부의 드라이버가 선택한 미디엄에 특징지어진다.

주석

패킷 디스크립터에 플래그를 설정하는 것은 프로토콜 드라이버가 패킷 데이타에 포함되지 않는, 보내기 리퀘스트에 대한 정보를 전달하는 것을 허락한다.

프로토콜 드라이버는 신속하게 처리되는 방법으로 데이타를 전송하는 어떤 미디엄 상에서 보내진 패킷 안의 플래그를 설정하기 위해서 일반적으로 NdisSetPacketFlags 함수를 호출한다. 몇몇 미디어 타입은 보내기 패킷에 체인화된 버퍼안에 포함되는 패킷의 헤더안에 플래그 정보를 포함한다. 프로토콜 드라이버가 이 미디어 타입을 위해서 하부의 드라이버와 바인딩했을 때 NdisSetPacketFlags 함수의 호출은 불필요하다.

바인딩된 프로토콜이 NdisSetPacketFlags 함수를 호출했을 때 하부 드라이버의 MiniportSendPackets 함수는 NdisGetPacketFlags 함수를 호출하므로써만 이 플래그들을 읽을 수 있다. MiniportSend 함수를 가진 하부의 드라이버에 대해서 NdisGetPacketFlags 함수의 호출은 플래그가 MiniportSend 함수의 입력 파라미터로 전달되기 때문에 불필요하다.

NdisAllocatePacket 함수를 가지고 할당된 모든 패킷 디스크립터들은 0 으로 초기화된 플래그를 가지고 있다. NdisGetPacketFlags 함수에 의해서 리턴된 값이 0 이라면 하부의 드라이버는 패킷이 프로토콜 설정 플래그 정보를 가지고 있지 않다고 가정할 수 있다.

그러나 프로토콜은 싱글 패킷을 허락하는 NdisSetPacketFlags 함수를 호출하는 것보다 각각의 패킷 디스크립터와 연관된 OOB 데이타 블럭 안에 패킷 우선권과 같은 훨씬 더 많은 미디어 특정 정보를 제공할 수 있다.

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