DMA_START_HANDLER fonction de rappel (netdma.h)

Article
07/02/2025

Remarque L’interface NetDMA n’est pas prise en charge

dans Windows 8 et versions ultérieures.

La fonction ProviderStartDma démarre un transfert DMA sur le canal DMA spécifié.

Syntaxe

DMA_START_HANDLER DmaStartHandler;

NTSTATUS DmaStartHandler(
  [in] PVOID ProviderChannelContext,
  [in] PNET_DMA_DESCRIPTOR DescriptorVirtualAddress,
  [in] PHYSICAL_ADDRESS DescriptorPhysicalAddress,
  [in] ULONG DescriptorCount
)
{...}

Paramètres

[in] ProviderChannelContext

Pointeur qui identifie la zone de contexte d’un canal DMA. Le fournisseur DMA a retourné ce handle à NetDMA à l’emplacement spécifié dans le paramètre pProviderChannelContext du paramètre fonction ProviderAllocateDmaChannel.

[in] DescriptorVirtualAddress

Pointeur vers l’adresse virtuelle de la première structure de NET_DMA_DESCRIPTOR dans une liste liée de descripteurs DMA. L’adresse physique correspondante est spécifiée au paramètre DescriptorPhysicalAddress.

[in] DescriptorPhysicalAddress

Pointeur vers l’adresse physique du premier descripteur DMA dans une liste liée de descripteurs DMA. L’adresse virtuelle correspondante est spécifiée au paramètre DescriptorVirtualAddress.

[in] DescriptorCount

Nombre de descripteurs DMA à DescriptorVirtualAddress .

Remarque pilotes de fournisseur NetDMA avant NetDMA version 2.0 peut ignorer le paramètre DescriptorCount. Pour NetDMA 2.0 et versions ultérieures, ce paramètre est le nombre de descripteurs dans l’opération DMA.

Valeur de retour

ProviderStartDma retourne l’une des valeurs d’état suivantes :

Retourner le code	Description
STATUS_SUCCESS	L’opération s’est terminée avec succès.
STATUS_RESOURCES	L’opération a échoué en raison de ressources insuffisantes.
STATUS_UNSUCCESSFUL	L’opération a échoué pour des raisons non spécifiées.

Remarques

L’interface NetDMA appelle la fonction ProviderStartDma du pilote de fournisseur DMA pour démarrer un transfert DMA. L’interface NetDMA peut appeler ProviderStartDma à tout moment après l’allocation d’un canal DMA. L’interface NetDMA doit appeler ProviderStartDma après avoir appelé le ProviderAbortDma, ProviderResetChannelou ProviderAllocateDmaChannel fonction pour un canal DMA.

La source du transfert DMA est une liste liée de descripteurs DMA. Le NextDescriptor membre de la structure NET_DMA_DESCRIPTOR au paramètre DescriptorVirtualAddress contient l’adresse physique de la structure de NET_DMA_DESCRIPTOR suivante dans la liste liée.

Remarque dans NetDMA 2.0 et versions ultérieures, la liste liée des descripteurs n’est pas terminée par NULL. Le NextDescriptor membre dans le dernier descripteur de la liste liée spécifie l’adresse physique de la structure NET_DMA_DESCRIPTOR qui sera utilisée dans l’appel suivant à la fonction ProviderAppendDma. Un pilote de fournisseur NetDMA 2.0 peut mettre en cache l’adresse dans NextDescriptor et utiliser cette adresse comme début de la liste liée pour l’opération Append suivante.

Pour effectuer l’opération de démarrage, le fournisseur DMA doit ignorer la liste de descripteur DMA existante, le cas échéant, une fois qu’il a terminé tout traitement sur le descripteur actuel. Le fournisseur DMA doit ignorer le membre NextDescriptor dans la structure de NET_DMA_DESCRIPTOR actuelle et charger le descripteur spécifié ProviderStartDma.

Après ProviderStartDma démarre le transfert DMA initial, l’interface NetDMA peut appeler la fonction ProviderAppendDma pour ajouter des données supplémentaires au transfert.

NetDMA appelle ProviderStartDma au <IRQL = DISPATCH_LEVEL.

Exigences

Exigence	Valeur
client minimum pris en charge	Pris en charge pour les pilotes NetDMA 2.0 dans Windows Server 2008. Pris en charge pour les pilotes NetDMA 1.1 dans Windows Server 2008. Pris en charge pour les pilotes NetDMA 1.0 dans Windows Server 2008 et Windows Vista.
plateforme cible	Windows
d’en-tête	netdma.h (include Netdma.h)
IRQL	<= DISPATCH_LEVEL