struktur NET_DMA_PROVIDER_CHARACTERISTICS (netdma.h)

Artikel
03/05/2024

Catatan Antarmuka NetDMA tidak didukung di Windows 8 dan yang lebih baru.

Struktur NET_DMA_PROVIDER_CHARACTERISTICS menentukan karakteristik untuk penyedia NetDMA, termasuk titik masuk untuk fungsi ProviderXxx .

Sintaks

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;

Anggota

MajorVersion

Nomor versi utama driver penyedia DMA.

MinorVersion

Nomor versi minor driver penyedia DMA.

Size

Ukuran, dalam byte, dari struktur NET_DMA_PROVIDER_CHARACTERISTICS ini. Atur anggota ini ke sizeof(NET_DMA_PROVIDER_CHARACTERISTICS).

Flags

Bendera karakteristik penyedia DMA. Driver NetDMA 1.0 dan 1.1 mengatur anggota ini ke nol.

Driver NetDMA 2.0 dan yang lebih baru dapat menggunakan bendera berikut.

NET_DMA_PROVIDER_CHARACTERISTICS_DCA_SUPPORTED

Penyedia NetDMA mendukung Direct Cache Access (DCA).

PhysicalDeviceObject

Objek perangkat fisik (PDO) yang terkait dengan penyedia DMA. Manajer Plug and Play (PnP) memasok pointer ke PDO pada parameter PhysicalDeviceObject ke rutinitas AddDevice.

MaxDmaChannelCount

Jumlah maksimum saluran DMA yang dapat didukung penyedia DMA.

SetDmaChannelCpuAffinity

Titik masuk untuk Fungsi ProviderSetDmaChannelCpuAffinity .

AllocateDmaChannel

Titik masuk untuk Fungsi ProviderAllocateDmaChannel .

FreeDmaChannel

Titik masuk untuk Fungsi ProviderFreeDmaChannel .

StartDma

Titik masuk untuk fungsi ProviderStartDma .

SuspendDma

Titik masuk untuk fungsi ProviderSuspendDma . Jika fungsi ini tidak didukung, atur anggota ini ke NULL.

ResumeDma

Titik masuk untuk fungsi ProviderResumeDma . Jika fungsi ini tidak didukung, atur anggota ini ke NULL.

AbortDma

Titik masuk untuk fungsi ProviderAbortDma . Jika fungsi ini tidak didukung, atur anggota ini ke NULL.

AppendDma

Titik masuk untuk fungsi ProviderAppendDma .

ResetChannel

Titik masuk untuk fungsi ProviderResetChannel . Jika fungsi ini tidak didukung, atur anggota ini ke NULL.

FriendlyName

String Unicode yang mewakili deskripsi driver penyedia NetDMA yang dapat dibaca pengguna.

Keterangan

Untuk mendaftarkan penyedia DMA, driver penyedia DMA memanggil fungsi NetDmaRegisterProvider dari rutinitas AddDevice-nya .

Driver penyedia DMA menyediakan struktur NET_DMA_PROVIDER_CHARACTERISTICS pada parameter ProviderCharacteristics dari NetDmaRegisterProvider.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Didukung untuk driver NetDMA 2.0 di Windows Server 2008. (Menambahkan anggota FriendlyName.) Didukung untuk driver NetDMA 1.1 di Windows Server 2008. Didukung untuk driver NetDMA 1.0 di Windows Server 2008 dan Windows Vista.
Header	netdma.h (termasuk Netdma.h)