NET_DMA_PROVIDER_CHARACTERISTICS struttura (netdma.h)

Articolo
08/07/2023

Nota L'interfaccia NetDMA non è supportata in Windows 8 e versioni successive.

La struttura NET_DMA_PROVIDER_CHARACTERISTICS specifica le caratteristiche per un provider NetDMA, inclusi i punti di ingresso per le funzioni ProviderXxx .

Sintassi

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;

Members

MajorVersion

Numero di versione principale del driver del provider DMA.

MinorVersion

Numero di versione secondaria del driver del provider DMA.

Size

Dimensioni, in byte, di questa struttura NET_DMA_PROVIDER_CHARACTERISTICS. Impostare questo membro su sizeof(NET_DMA_PROVIDER_CHARACTERISTICS).

Flags

Flag delle caratteristiche del provider DMA. I driver NetDMA 1.0 e 1.1 impostano questo membro su zero.

I driver NetDMA 2.0 e versioni successive possono usare i flag seguenti.

NET_DMA_PROVIDER_CHARACTERISTICS_DCA_SUPPORTED

Il provider NetDMA supporta l'accesso diretto alla cache (DCA).

PhysicalDeviceObject

Oggetto dispositivo fisico (PDO) associato al provider DMA. Il gestore Plug and Play (PnP) fornisce un puntatore al pdO nel parametro PhysicalDeviceObject alla routine AddDevice.

MaxDmaChannelCount

Numero massimo di canali DMA supportati dal provider DMA.

SetDmaChannelCpuAffinity

Punto di ingresso per l'oggetto Funzione ProviderSetDmaChannelCpuAffinity .

AllocateDmaChannel

Punto di ingresso per l'oggetto Funzione ProviderAllocateDmaChannel .

FreeDmaChannel

Punto di ingresso per l'oggetto Funzione ProviderFreeDmaChannel .

StartDma

Punto di ingresso per la funzione ProviderStartDma .

SuspendDma

Punto di ingresso per la funzione ProviderSuspendDma . Se questa funzione non è supportata, impostare questo membro su NULL.

ResumeDma

Punto di ingresso per la funzione ProviderResumeDma . Se questa funzione non è supportata, impostare questo membro su NULL.

AbortDma

Punto di ingresso per la funzione ProviderAbortDma . Se questa funzione non è supportata, impostare questo membro su NULL.

AppendDma

Punto di ingresso per la funzione ProviderAppendDma .

ResetChannel

Punto di ingresso per la funzione ProviderResetChannel . Se questa funzione non è supportata, impostare questo membro su NULL.

FriendlyName

Stringa Unicode che rappresenta la descrizione leggibile dall'utente del driver del provider NetDMA.

Commenti

Per registrare un provider DMA, un driver del provider DMA chiama la funzione NetDmaRegisterProvider dalla routine AddDevice .

Il driver del provider DMA fornisce una struttura NET_DMA_PROVIDER_CHARACTERISTICS nel parametro ProviderCharacteristics di NetDmaRegisterProvider.

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NetDMA 2.0 in Windows Server 2008. Aggiunta del membro FriendlyName. Supportato per i driver NetDMA 1.1 in Windows Server 2008. Supportato per i driver NetDMA 1.0 in Windows Server 2008 e Windows Vista.
Intestazione	netdma.h (include Netdma.h)