PFREE_ADAPTER_CHANNEL fonction de rappel (wdm.h)
La routine FreeAdapterChannel libère le contrôleur DMA système lorsqu’un pilote a effectué toutes les opérations DMA nécessaires pour satisfaire l’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 de master bus ou le contrôleur DMA.
Valeur de retour
None
Remarques
FreeAdapterChannel n’est pas une routine système qui peut être appelée directement par nom. Cette routine peut être appelée 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 précédemment alloué avec un appel à AllocateAdapterChannel.
FreeAdapterChannel libère tous les registres de carte qui ont été alloués par un appel antérieur à AllocateAdapterChannel. Un pilote appelle cette routine uniquement si sa routine AdapterControl retourne KeepObject.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 2000. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| 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) |