NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA 함수(netadapter.h)
NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA 함수는 메모리 매핑을 위한 DMA뿐만 아니라 운영 체제 관리 수신 버퍼 할당 및 첨부 파일을 지정하려는 net 어댑터에 대한 NET_ADAPTER_RX_CAPABILITIES 구조를 초기화합니다.
구문
void NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA(
[_Out_] NET_ADAPTER_RX_CAPABILITIES *RxCapabilities,
[_In_] NET_ADAPTER_DMA_CAPABILITIES *DmaCapabilities,
[_In_] SIZE_T MaximumFrameSize,
[_In_] SIZE_T MaximumNumberOfQueues
);
매개 변수
[_Out_] RxCapabilities
드라이버 할당 NET_ADAPTER_RX_CAPABILITIES 구조체에 대한 포인터입니다.
[_In_] DmaCapabilities
드라이버 할당 및 초기화된 NET_ADAPTER_DMA_CAPABILITIES 구조체에 대한 포인터입니다.
[_In_] MaximumFrameSize
어댑터가 받을 수 있는 최대 프레임 크기(바이트)입니다.
[_In_] MaximumNumberOfQueues
어댑터가 지원하는 최대 수신 큐 수입니다.
반환 값
없음
설명
이 함수는 NET_ADAPTER_RX_CAPABILITIES 구조를 초기화하기 위해 호출할 수 있는 세 가지 함수 중 하나입니다. 클라이언트 드라이버가 호출해야 하는 것은 수신 버퍼를 할당하는 방법과 DMA를 사용하려는 경우에 따라 달라집니다.
클라이언트 드라이버는 NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA 호출하여 운영 체제가 수신 버퍼 할당 및 첨부 파일을 수행하도록 하고 수신 데이터 경로에서 DMA를 사용하려는 경우 NET_ADAPTER_RX_CAPABILITIES 구조를 초기 화해야 합니다. 이 함수를 호출하면 Rx 기능 구조체의 AllocationMode 멤버가 NetRxFragmentBufferAllocationModeSystem 으로 설정되고 AttachmentMode 멤버가 NetRxFragmentBufferAttachmentModeSystem으로 설정됩니다.
NET_ADAPTER_RX_CAPABILITIES_INIT_SYSTEM_MANAGED_DMA 호출하기 전에 드라이버는 NET_ADAPTER_DMA_CAPABILITIES 구조를 할당하고 NET_ADAPTER_DMA_CAPABILITIES_INIT 사용하여 초기화해야 합니다. 그런 다음 이 DMA 기능 구조는 NET_ADAPTER_RX_CAPABILITIES 구조체의 DmaCapabilities 멤버에 할당됩니다.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 유니버설 |
최소 KMDF 버전 | 1.25 |
머리글 | netadapter.h(netadaptercx.h 포함) |
IRQL | PASSIVE_LEVEL |