EVT_PACKET_QUEUE_STOP 콜백 함수(netpacketqueue.h)

아티클
03/01/2024

EvtPacketQueueStop 콜백 함수는 클라이언트 드라이버가 패킷 큐의 데이터 경로를 중지하기 위해 구현하는 선택적 콜백입니다.

구문

EVT_PACKET_QUEUE_STOP EvtPacketQueueStop;

void EvtPacketQueueStop(
  [_In_] NETPACKETQUEUE PacketQueue
)
{...}

매개 변수

[_In_] PacketQueue

패킷 큐에 대한 핸들입니다.

반환 값

없음

설명

선택적 콜백입니다. 이 콜백 함수를 EVT_NET_ADAPTER_CREATE_TX(rxQueueContext)QUEUE 콜백에 등록합니다. NET_PACKET_QUEUE_CONFIG_INIT 사용하여 구조를 초기화한 후 NET_PACKET_QUEUE_CONFIG 구조체의 적절한 멤버를 설정한 다음 NetTx(rxQueueContext)QueueCreate를 호출합니다.

이 콜백은 값을 반환하지 않으므로 실패하면 안 되므로 이 콜백은 빠르게 실행되는 경량 함수여야 합니다.

클라이언트 드라이버는 EvtPacketQueueStop이 반환된 후 EVT_PACKET_QUEUE_ADVANCE, EVT_PACKET_QUEUE_CANCEL 또는 EVT_PACKET_QUEUE_SET_NOTIFICATION_ENABLED 대한 호출을 받지 않습니다. 또한 EvtPacketQueueStop은 EvtPacketQueueAdvance, EvtPacketQueueCancel 및 EvtPacketQueueSetNotificationEnabled와 같은 실행 컨텍스트 또는 스레드에서 호출되므로 클라이언트 드라이버는 개별 큐 instance 대해 이러한 콜백 함수 간에 동기화할 필요가 없습니다.

NetAdapterCx 데이터 경로 폴링 모델을 보여 주는 자세한 정보 및 다이어그램은 큐 전송 및 받기를 참조하세요.