NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED 함수(netadapter.h)

아티클
02/26/2024

NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED 함수는 운영 체제 관리 수신 버퍼 할당 및 첨부 파일을 지정하지만 DMA 메모리 매핑을 사용하지 않는 net 어댑터에 대한 NET_ADAPTER_RX_CAPABILITIES 구조를 초기화합니다.

구문

void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED(
  [_Out_] NET_ADAPTER_RX_CAPABILITIES *RxCapabilities,
  [_In_]  SIZE_T                      MaximumFrameSize,
  [_In_]  SIZE_T                      MaximumNumberOfQueues
);

매개 변수

[_Out_] RxCapabilities

드라이버 할당 NET_ADAPTER_RX_CAPABILITIES 구조체에 대한 포인터입니다.

[_In_] MaximumFrameSize

어댑터가 받을 수 있는 최대 프레임 크기(바이트)입니다.

[_In_] MaximumNumberOfQueues

어댑터가 지원하는 최대 수신 큐 수입니다.

반환 값

없음

설명

이 함수는 NET_ADAPTER_RX_CAPABILITIES 구조를 초기화하기 위해 호출할 수 있는 세 가지 함수 중 하나입니다. 클라이언트 드라이버가 호출해야 하는 것은 수신 버퍼를 할당하는 방법과 DMA를 사용하려는 경우에 따라 달라집니다.

클라이언트 드라이버는 운영 체제가 수신 버퍼 할당 및 첨부 파일을 수행하되 DMA 메모리 매핑이 필요하지 않은 경우 NET_ADAPTER_RX_CAPABILITIES 구조를 초기화하기 위해 NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED 호출해야 합니다. 이 함수를 호출하면 Rx 기능 구조체의 AllocationMode 멤버가 NetRxFragmentBufferAllocationModeSystem 으로 설정되고 AttachmentMode 멤버가 NetRxFragmentBufferAttachmentModeSystem으로 설정됩니다. 이 경우 드라이버는 DMA 기능을 지정하지 않으므로 이 함수는 MappingRequirement 멤버를 NetMemoryMappingRequirementNone으로 설정합니다.