Méthode IDmaChannelSlave ::WaitForTC (portcls.h)
La méthode WaitForTC attend que le nombre de terminaux de transfert DMA se termine, ou expire si l’intervalle de délai d’attente spécifié expire en premier.
Syntaxe
NTSTATUS WaitForTC(
ULONG Timeout
);
Paramètres
Timeout
Spécifie l’intervalle de délai d’attente en microsecondes. Cet intervalle est la durée pendant laquelle la méthode attend que le transfert se termine avant d’expirer. L’intervalle de délai d’attente spécifié est arrondi à l’incrément de dix microsecondes le plus proche.
Valeur retournée
La méthode WaitForTC retourne NTSTATUS. Il retourne STATUS_SUCCESS si l’appel a réussi. Sinon, la méthode retourne un code d’erreur approprié.
Remarques
Notes
Microsoft prend en charge un environnement diversifié et inclusif. Cet article contient des références à la terminologie que le guide de style Microsoft pour la communication sans préjugés reconnaît comme exclusion. Le mot ou l’expression est utilisé dans cet article à des fins de cohérence, car il apparaît actuellement dans le logiciel. Lorsque le logiciel est mis à jour pour supprimer la langue, cet article est mis à jour pour être aligné.
Cette méthode ne doit être appelée que dans deux situations :
Après avoir envoyé une demande d’arrêt au matériel, le pilote miniport appelle WaitForTC afin d’attendre que la DMA se termine avant de poursuivre l’exécution.
Dans le cas d’un matériel DMA qui n’est pas initialisé automatiquement, le pilote miniport peut appeler WaitForTC à tout moment pour attendre qu’un transfert DMA se termine.
Étant donné que cette méthode attend simplement que le transfert DMA se termine ou expire, les appelants de WaitForTC doivent s’exécuter au PASSIVE_LEVEL IRQL.
Configuration requise
Condition requise | Valeur |
---|---|
En-tête | portcls.h |
IRQL | PASSIVE_LEVEL (voir la section Remarques).) |