estructura NET_DMA_PROVIDER_CHARACTERISTICS (netdma.h)
Sintaxis
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;
Miembros
MajorVersion
Número de versión principal del controlador del proveedor DMA.
MinorVersion
Número de versión secundaria del controlador del proveedor DMA.
Size
Tamaño, en bytes, de esta estructura NET_DMA_PROVIDER_CHARACTERISTICS. Establezca este miembro en sizeof(NET_DMA_PROVIDER_CHARACTERISTICS).
Flags
Marcas de características del proveedor DMA. Los controladores NetDMA 1.0 y 1.1 establecen este miembro en cero.
NetDMA 2.0 y los controladores posteriores pueden usar las marcas siguientes.
NET_DMA_PROVIDER_CHARACTERISTICS_DCA_SUPPORTED
El proveedor netDMA admite direct Cache Access (DCA).
PhysicalDeviceObject
Objeto de dispositivo físico (PDO) asociado al proveedor DMA. El administrador plug and play (PnP) proporciona un puntero al PDO en el parámetro PhysicalDeviceObject a la rutina AddDevice.
MaxDmaChannelCount
Número máximo de canales DMA que puede admitir el proveedor DMA.
SetDmaChannelCpuAffinity
El punto de entrada del objeto función ProviderSetDmaChannelCpuAffinity.
AllocateDmaChannel
El punto de entrada del objeto función providerAllocateDmaChannel.
FreeDmaChannel
El punto de entrada del objeto función ProviderFreeDmaChannel.
StartDma
Punto de entrada de la función ProviderStartDma.
SuspendDma
Punto de entrada de la función providerSuspendDma de. Si no se admite esta función, establezca este miembro en NULL.
ResumeDma
Punto de entrada de la función providerResumeDma de. Si no se admite esta función, establezca este miembro en NULL.
AbortDma
Punto de entrada de la función ProviderAbortDma de. Si no se admite esta función, establezca este miembro en NULL.
AppendDma
Punto de entrada de la función ProviderAppendDma de.
ResetChannel
Punto de entrada de la función ProviderResetChannel. Si no se admite esta función, establezca este miembro en NULL.
FriendlyName
Cadena Unicode que representa la descripción legible por el usuario del controlador del proveedor netDMA.
Observaciones
Para registrar un proveedor DMA, un controlador de proveedor DMA llama a la función NetDmaRegisterProvider desde su rutina de addDevice.
El controlador de proveedor DMA proporciona una estructura de NET_DMA_PROVIDER_CHARACTERISTICS en el parámetro ProviderCharacteristics de NetDmaRegisterProvider.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Compatible con controladores netDMA 2.0 en Windows Server 2008. (Se ha agregado el miembro FriendlyName). Compatible con controladores netDMA 1.1 en Windows Server 2008. Compatible con controladores netDMA 1.0 en Windows Server 2008 y Windows Vista. |
| encabezado de | netdma.h (incluya Netdma.h) |