IDmaChannelSlave::WaitForTC-Methode (portcls.h)

  • Artikel

Die WaitForTC-Methode wartet auf den Abschluss der DMA-Übertragungsterminalanzahl, oder es tritt ein Timeout auf, wenn das angegebene Timeoutintervall zuerst abläuft.

Syntax

NTSTATUS WaitForTC(
  ULONG Timeout
);

Parameter

Timeout

Gibt das Timeoutintervall in Mikrosekunden an. Dieses Intervall ist die Zeitspanne, die die Methode auf den Abschluss der Übertragung wartet, bevor ein Timeout auftritt. Das angegebene Timeoutintervall wird auf das nächste Zehn-Mikrosekunden-Inkrement abgerundet.

Rückgabewert

Die WaitForTC-Methode gibt NTSTATUS zurück. Es wird STATUS_SUCCESS zurückgegeben, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück.

Hinweise

Hinweis

Microsoft unterstützt eine vielfältige und inklusive Umgebung. Dieser Artikel enthält Verweise auf Terminologie, die im Microsoft-Stilleitfaden für voreingenommene Kommunikation als ausschlussfrei erkannt wird. Das Wort oder der Ausdruck wird in diesem Artikel aus Gründen der Konsistenz verwendet, da es derzeit in der Software angezeigt wird. Wenn die Software aktualisiert wird, um die Sprache zu entfernen, wird dieser Artikel aktualisiert, um in Übereinstimmung zu sein.

Diese Methode sollte nur in zwei Situationen aufgerufen werden:

  1. Nach dem Senden einer Anforderung an die Hardware, die beendet werden soll, ruft der Miniporttreiber WaitForTC auf, um auf den Abschluss des DMA zu warten, bevor die Ausführung fortgesetzt wird.

  2. Bei DMA-Hardware, die nicht automatisch initialisiert wird, kann der Miniporttreiber jederzeit WaitForTC aufrufen, um zu warten, bis eine DMA-Übertragung abgeschlossen ist.

Da diese Methode einfach wartet, bis die DMA-Übertragung entweder abgeschlossen oder ein Timeout aufgetreten ist, müssen Aufrufer von WaitForTC im IRQL-PASSIVE_LEVEL ausgeführt werden.

Anforderungen

Anforderung Wert
Header portcls.h
IRQL PASSIVE_LEVEL (Siehe Abschnitt "Hinweise").

Weitere Informationen

IDmaChannelSlave-Schnittstelle