NET_DMA_PROVIDER_CHARACTERISTICS構造体 (netdma.h)

[アーティクル]
02/26/2024

メモ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 プロバイダーは、Direct Cache Access (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 プロバイダードライバーのユーザーが読み取り可能な説明を表す Unicode 文字列。

注釈

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 ドライバーでサポートされます。
Header	netdma.h (Netdma.h を含む)