estrutura NET_DMA_PROVIDER_CHARACTERISTICS (netdma.h)
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) |