NetRxQueueCreate 함수(netrxqueue.h)

  • 아티클

net receive queue 개체를 만듭니다.

구문

NTSTATUS NetRxQueueCreate(
  [_Inout_]  NETRXQUEUE_INIT         *NetRxQueueInit,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES   *RxQueueAttributes,
  [_In_]     NET_PACKET_QUEUE_CONFIG *Configuration,
  [_Out_]    NETPACKETQUEUE          *PacketQueue
);

매개 변수

[_Inout_] NetRxQueueInit

클라이언트 드라이버가 EVT_NET_ADAPTER_CREATE_RXQUEUE 콜백 함수에서 받은 NETRXQUEUE_INIT 구조체에 대한 포인터입니다.

[_In_opt_] RxQueueAttributes

호출자가 할당하고 초기화된 WDF_OBJECT_ATTRIBUTES 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 WDF_NO_OBJECT_ATTRIBUTES 수 있습니다. 그러나 클라이언트 드라이버가 이 매개 변수를 제공하는 경우 ParentObject 필드는 NULL이어야 합니다.

[_In_] Configuration

호출자가 할당한 NET_PACKET_QUEUE_CONFIG 구조체에 대한 포인터입니다.

[_Out_] PacketQueue

새 net receive queue 개체에 대한 핸들을 받는 위치에 대한 포인터입니다.

반환 값

이 함수는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 함수가 적절한 NTSTATUS 오류 코드를 반환할 수 있습니다.

설명

클라이언트는 EVT_NET_ADAPTER_CREATE_RXQUEUE 이벤트 콜백 함수 내에서 NetRxQueueCreate를 호출합니다. 새 개체에 컨텍스트 공간을 할당하는 방법에 대한 자세한 내용은 프레임워크 개체 컨텍스트 공간을 참조하세요.

NETPACKETQUEUE 개체는 표준 WDF 개체입니다. 프레임워크는 부모 NETADAPTER 개체를 삭제할 때 발생하는 삭제를 관리합니다.

요구 사항

요구 사항 값
대상 플랫폼 유니버설
최소 KMDF 버전 1.27
머리글 netrxqueue.h(netadaptercx.h 포함)
라이브러리 NetAdapterCxStub.lib
IRQL PASSIVE_LEVEL