EVT_NET_ADAPTER_CREATE_RXQUEUE 콜백 함수(netadapter.h)
수신(Rx) 큐를 설정하는 EvtNetAdapterCreateRxQueue 이벤트 콜백 함수의 클라이언트 드라이버 구현입니다.
구문
EVT_NET_ADAPTER_CREATE_RXQUEUE EvtNetAdapterCreateRxqueue;
NTSTATUS EvtNetAdapterCreateRxqueue(
[_In_] NETADAPTER Adapter,
[_Inout_] NETRXQUEUE_INIT *RxQueueInit
)
{...}
매개 변수
[_In_] Adapter
NetAdapterCreate에 대한 이전 호출에서 클라이언트가 만든 네트워크 어댑터 개체입니다.
[_Inout_] RxQueueInit
NetAdapterCx 할당 NETRXQUEUE_INIT 구조체에 대한 포인터입니다. 자세한 내용은 주의 섹션을 참조하세요.
반환 값
작업이 성공하면 콜백 함수는 STATUS_SUCCESS 반환하거나 NT_SUCCESS(상태)이 TRUE인 다른 상태 값을 반환해야 합니다. 그렇지 않으면 적절한 NTSTATUS 오류 코드입니다.
설명
EVT_NET_ADAPTER_CREATE_RXQUEUE 콜백 함수를 등록하려면 클라이언트 드라이버가 NetAdapterCreate를 호출해야 합니다.
NETRXQUEUE_INIT 구조체는 WDFDEVICE_INIT 유사하게 NetAdapterCx에서 정의하고 할당하는 불투명 구조체입니다.
이 콜백에서 클라이언트 드라이버는 NetRxQueueInitGetQueueId 를 호출하여 설정할 수신 큐의 식별자를 검색할 수 있습니다. 다음으로, 클라이언트는 NetRxQueueCreate 를 호출하여 큐를 할당합니다. NetRxQueueCreate가 실패하면 EvtNetAdapterCreateRxQueue 콜백 함수는 오류 코드를 반환해야 합니다.
NetAdapterCx는 전원 강화 시퀀스의 맨 끝에서 EvtNetAdapterCreateRxQueue를 호출합니다.
이 콜백 함수를 구현하는 코드 예제는 큐 전송 및 받기를 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 유니버설 |
최소 KMDF 버전 | 1.29 |
최소 UMDF 버전 | 2.33 |
머리글 | netadapter.h(netadaptercx.h 포함) |
IRQL | PASSIVE_LEVEL |