Поделиться через


Метод IDmaChannelSlave::WaitForTC (portcls.h)

Метод WaitForTC ожидает завершения числа терминалов передачи DMA или истекает, если указанный интервал ожидания истекает первым.

Синтаксис

NTSTATUS WaitForTC(
  ULONG Timeout
);

Параметры

Timeout

Указывает интервал времени ожидания в микросекундах. Этот интервал представляет собой промежуток времени, в течение времени, когда метод ожидает завершения передачи. Указанный интервал времени ожидания округляется до ближайшего приращения в десять микросекунд.

Возвращаемое значение

Метод WaitForTC возвращает NTSTATUS. Он возвращает STATUS_SUCCESS, если вызов был успешным. В противном случае метод возвращает соответствующий код ошибки.

Комментарии

Примечание

Корпорация Майкрософт поддерживает разнообразную и инклюзивную среду. В этой статье содержатся ссылки на терминологию, которую руководство майкрософт по стилю для общения без предубеждений распознает как исключающую. Слово или фраза используется в этой статье для обеспечения согласованности, так как они в настоящее время отображаются в программном обеспечении. При обновлении программного обеспечения для удаления языка эта статья будет обновлена до выравнивания.

Этот метод следует вызывать только в двух ситуациях:

  1. После отправки запроса на остановку оборудования драйвер мини-порта вызывает WaitForTC, чтобы дождаться завершения DMA, прежде чем продолжить выполнение.

  2. В случае оборудования DMA, которое не инициализировано автоматически, драйвер мини-порта может вызвать WaitForTC в любое время, чтобы дождаться завершения передачи DMA.

Так как этот метод просто ожидает завершения передачи DMA или истечения времени ожидания, вызывающие функции WaitForTC должны выполняться на PASSIVE_LEVEL IRQL.

Требования

Требование Значение
Заголовок portcls.h
IRQL PASSIVE_LEVEL (см. раздел "Примечания"))

См. также раздел

Интерфейс IDmaChannelSlave