NET_DMA_PROVIDER_CHARACTERISTICS 구조체(netdma.h)

아티클
08/07/2023

참고 NetDMA 인터페이스는 Windows 8 이상에서 지원되지 않습니다.

NET_DMA_PROVIDER_CHARACTERISTICS 구조체는 ProviderXxx 함수의 진입점을 포함하여 NetDMA 공급자의 특성을 지정합니다.

구문

typedef struct _NET_DMA_PROVIDER_CHARACTERISTICS {
  UCHAR                             MajorVersion;
  UCHAR                             MinorVersion;
  USHORT                            Size;
  ULONG                             Flags;
  PDEVICE_OBJECT                    PhysicalDeviceObject;
  ULONG                             MaxDmaChannelCount;
  DMA_CHANNELS_CPU_AFFINITY_HANDLER SetDmaChannelCpuAffinity;
  DMA_CHANNEL_ALLOCATE_HANDLER      AllocateDmaChannel;
  DMA_CHANNEL_FREE_HANDLER          FreeDmaChannel;
  DMA_START_HANDLER                 StartDma;
  DMA_SUSPEND_HANDLER               SuspendDma;
  DMA_RESUME_HANDLER                ResumeDma;
  DMA_ABORT_HANDLER                 AbortDma;
  DMA_APPEND_HANDLER                AppendDma;
  DMA_RESET_HANDLER                 ResetChannel;
  UNICODE_STRING                    FriendlyName;
} NET_DMA_PROVIDER_CHARACTERISTICS, *PNET_DMA_PROVIDER_CHARACTERISTICS;

멤버

MajorVersion

DMA 공급자 드라이버의 주 버전 번호입니다.

MinorVersion

DMA 공급자 드라이버의 부 버전 번호입니다.

Size

이 NET_DMA_PROVIDER_CHARACTERISTICS 구조체의 크기(바이트)입니다. 이 멤버를 sizeof(NET_DMA_PROVIDER_CHARACTERISTICS)로 설정합니다.

Flags

DMA 공급자 특성 플래그입니다. NetDMA 1.0 및 1.1 드라이버는 이 멤버를 0으로 설정합니다.

NetDMA 2.0 이상 드라이버는 다음 플래그를 사용할 수 있습니다.

NET_DMA_PROVIDER_CHARACTERISTICS_DCA_SUPPORTED

NetDMA 공급자는 DCA(직접 캐시 액세스)를 지원합니다.

PhysicalDeviceObject

DMA 공급자와 연결된 PDO(물리적 디바이스 개체)입니다. 플러그 앤 플레이(PnP) 관리자는 PhysicalDeviceObject 매개 변수의 PDO에 대한 포인터를 AddDevice 루틴에 제공합니다.

MaxDmaChannelCount

DMA 공급자가 지원할 수 있는 최대 DMA 채널 수입니다.

SetDmaChannelCpuAffinity

의 진입점 ProviderSetDmaChannelCpuAffinity 함수입니다.

AllocateDmaChannel

의 진입점 ProviderAllocateDmaChannel 함수입니다.

FreeDmaChannel

의 진입점 ProviderFreeDmaChannel 함수입니다.

StartDma

ProviderStartDma 함수의 진입점입니다.

SuspendDma

ProviderSuspendDma 함수의 진입점입니다. 이 함수가 지원되지 않는 경우 이 멤버를 NULL로 설정합니다.

ResumeDma

ProviderResumeDma 함수의 진입점입니다. 이 함수가 지원되지 않는 경우 이 멤버를 NULL로 설정합니다.

AbortDma

ProviderAbortDma 함수의 진입점입니다. 이 함수가 지원되지 않는 경우 이 멤버를 NULL로 설정합니다.

AppendDma

ProviderAppendDma 함수의 진입점입니다.

ResetChannel

ProviderResetChannel 함수의 진입점입니다. 이 함수가 지원되지 않는 경우 이 멤버를 NULL로 설정합니다.

FriendlyName

NetDMA 공급자 드라이버의 사용자가 읽을 수 있는 설명을 나타내는 유니코드 문자열입니다.

설명

DMA 공급자를 등록하기 위해 DMA 공급자 드라이버는 AddDevice 루틴에서 NetDmaRegisterProvider 함수를 호출합니다.

DMA 공급자 드라이버는 NetDmaRegisterProvider의 ProviderCharacteristics 매개 변수에 NET_DMA_PROVIDER_CHARACTERISTICS 구조를 제공합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Server 2008에서 NetDMA 2.0 드라이버에 대해 지원됩니다. (FriendlyName 멤버가 추가되었습니다.) Windows Server 2008에서 NetDMA 1.1 드라이버에 대해 지원됩니다. Windows Server 2008 및 Windows Vista에서 NetDMA 1.0 드라이버에 대해 지원됩니다.
머리글	netdma.h(Netdma.h 포함)