NET_DMA_PROVIDER_CHARACTERISTICS構造体 (netdma.h)
構文
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) マネージャーは、AddDevice ルーチンに、PhysicalDeviceObject パラメーターの PDO へのポインターを提供します。
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 プロバイダードライバーを登録するには、NetDmaRegisterProvider 関数を AddDevice ルーチンから呼び出します。
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 を含む) |
関連項目
AddDevice の
NetDmaRegisterProvider の
ProviderSetDmaChannelCpuAffinity