IDmaChannelSlave::WaitForTC-Methode (portcls.h)

Die WaitForTC-Methode wartet, bis die DMA-Übertragungsterminalanzahl abgeschlossen ist, oder es wird ein Timeout überschritten, wenn das angegebene Timeoutintervall zuerst abläuft.

Syntax

NTSTATUS WaitForTC(
  ULONG Timeout
);

Parameter

Timeout

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

Rückgabewert

Die WaitForTC-Methode gibt NTSTATUS zurück. Sie gibt STATUS_SUCCESS zurück, wenn der Anruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück.

Bemerkungen

Anmerkung

Microsoft unterstützt eine vielfältige und inklusive Umgebung. Dieser Artikel enthält Verweise auf die Terminologie, die vom Microsoft-Stilleitfaden für die biasfreie Kommunikation als Ausschluss erkannt wird. Das Wort oder der Ausdruck wird in diesem Artikel zur Konsistenz verwendet, da es derzeit in der Software angezeigt wird. Wenn die Software aktualisiert wird, um die Sprache zu entfernen, wird dieser Artikel so aktualisiert, dass er in Übereinstimmung steht.

Diese Methode sollte nur in zwei Situationen aufgerufen werden:

1. Nach dem Senden einer Anforderung an die Hardware zum Beenden ruft der Miniporttreiber WaitForTC auf, um zu warten, bis das DMA abgeschlossen ist, bevor die Ausführung fortgesetzt wird.

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

Da diese Methode einfach wartet, bis die DMA-Übertragung abgeschlossen ist oder ein Zeitüberschreitung erfolgt, müssen Aufrufer von WaitForTC unter IRQL-PASSIVE_LEVEL ausgeführt werden.

Anforderungen

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

Siehe auch

IDmaChannelSlave-Schnittstelle