PFREE_ADAPTER_CHANNEL fonction de rappel (wdm.h)
La routine FreeAdapterChannel libère le contrôleur DMA système lorsqu’un pilote a terminé toutes les opérations DMA nécessaires pour satisfaire le protocole IRP actuel.
Syntaxe
PFREE_ADAPTER_CHANNEL PfreeAdapterChannel;
void PfreeAdapterChannel(
[in] PDMA_ADAPTER DmaAdapter
)
{...}
Paramètres
[in] DmaAdapter
Pointeur vers la structure DMA_ADAPTER retournée par IoGetDmaAdapter qui représente l’adaptateur maître de bus ou le contrôleur DMA.
Valeur de retour
Aucun
Remarques
FreeAdapterChannel n’est pas une routine système qui peut être appelée directement par nom. Cette routine est appelante uniquement par le pointeur de l’adresse retournée dans une structure DMA_OPERATIONS. Les pilotes obtiennent l’adresse de cette routine en appelant IoGetDmaAdapter.
Une fois qu’un pilote a transféré toutes les données et appelé FlushAdapterBuffers, il appelle FreeAdapterChannel pour libérer le contrôleur DMA système qui a été précédemment alloué avec un appel à AllocateAdapterChannel.
FreeAdapterChannel libère tous les registres cartographiques alloués par un appel antérieur à AllocateAdapterChannel. Un pilote appelle cette routine uniquement si sa routine AdapterControl retourne KeepObject.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 2000. |
| plateforme cible | Bureau |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | DISPATCH_LEVEL |
| règles de conformité DDI | IrqlDispatch(storport), IrqlDispatch(storport), IrqlDispatch(wdm) |