estrutura NET_DMA_PROVIDER_CHARACTERISTICS (netdma.h)

Artigo
08/07/2023

Nota Não há suporte para a interface NetDMA em Windows 8 e posteriores.

A estrutura NET_DMA_PROVIDER_CHARACTERISTICS especifica as características de um provedor NetDMA, incluindo os pontos de entrada para as funções ProviderXxx .

Sintaxe

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;

Membros

MajorVersion

O número de versão principal do driver do provedor de DMA.

MinorVersion

O número de versão secundária do driver do provedor de DMA.

Size

O tamanho, em bytes, dessa estrutura NET_DMA_PROVIDER_CHARACTERISTICS. Defina esse membro como sizeof(NET_DMA_PROVIDER_CHARACTERISTICS).

Flags

Sinalizadores de características do provedor de DMA. Os drivers NetDMA 1.0 e 1.1 definem esse membro como zero.

Os drivers NetDMA 2.0 e posteriores podem usar os sinalizadores a seguir.

NET_DMA_PROVIDER_CHARACTERISTICS_DCA_SUPPORTED

O provedor NetDMA dá suporte ao Acesso direto ao cache (DCA).

PhysicalDeviceObject

O PDO (objeto de dispositivo físico) associado ao provedor de DMA. O gerenciador de Plug and Play (PnP) fornece um ponteiro para o PDO no parâmetro PhysicalDeviceObject para a rotina AddDevice.

MaxDmaChannelCount

O número máximo de canais de DMA aos quais o provedor de DMA pode dar suporte.

SetDmaChannelCpuAffinity

O ponto de entrada para o Função ProviderSetDmaChannelCpuAffinity .

AllocateDmaChannel

O ponto de entrada para o Função ProviderAllocateDmaChannel .

FreeDmaChannel

O ponto de entrada para o Função ProviderFreeDmaChannel .

StartDma

O ponto de entrada para a função ProviderStartDma .

SuspendDma

O ponto de entrada para a função ProviderSuspendDma . Se essa função não tiver suporte, defina esse membro como NULL.

ResumeDma

O ponto de entrada para a função ProviderResumeDma . Se essa função não tiver suporte, defina esse membro como NULL.

AbortDma

O ponto de entrada para a função ProviderAbortDma . Se essa função não tiver suporte, defina esse membro como NULL.

AppendDma

O ponto de entrada para a função ProviderAppendDma .

ResetChannel

O ponto de entrada para a função ProviderResetChannel . Se essa função não tiver suporte, defina esse membro como NULL.

FriendlyName

Uma cadeia de caracteres Unicode que representa a descrição legível pelo usuário do driver do provedor NetDMA.

Comentários

Para registrar um provedor de DMA, um driver de provedor de DMA chama a função NetDmaRegisterProvider de sua rotina AddDevice .

O driver do provedor de DMA fornece uma estrutura NET_DMA_PROVIDER_CHARACTERISTICS no parâmetro ProviderCharacteristics de NetDmaRegisterProvider.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte para drivers NetDMA 2.0 no Windows Server 2008. (Adicionado membro FriendlyName.) Com suporte para drivers NetDMA 1.1 no Windows Server 2008. Com suporte para drivers NetDMA 1.0 no Windows Server 2008 e no Windows Vista.
Cabeçalho	netdma.h (inclua Netdma.h)