Метод IDmaChannelSlave::WaitForTC (portcls.h)
Метод WaitForTC ожидает завершения счетчика терминала передачи DMA или истекает время ожидания, если указанный интервал ожидания истекает первым.
Синтаксис
NTSTATUS WaitForTC(
ULONG Timeout
);
Параметры
Timeout
Задает интервал времени ожидания в микросекундах. Этот интервал — это период времени ожидания передачи перед истечением времени ожидания передачи. Указанный интервал времени ожидания округляется до ближайшего десяти микросекунда.
Возвращаемое значение
Метод WaitForTC возвращает NTSTATUS. Он возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае метод возвращает соответствующий код ошибки.
Замечания
Заметка
Корпорация Майкрософт поддерживает разнообразную и инклюзивное окружение. В этой статье содержатся ссылки на терминологию, которую руководство по стилю Майкрософт для обмена данными без предвзятости распознает как исключение. Слово или фраза в этой статье используется для согласованности, так как она в настоящее время отображается в программном обеспечении. При обновлении программного обеспечения для удаления языка эта статья будет обновлена для выравнивания.
Этот метод должен вызываться только в двух ситуациях:
После отправки запроса на оборудование для остановки драйвер минипорта вызывает WaitForTC, чтобы ждать завершения DMA до продолжения выполнения.
В случае оборудования DMA, которое не инициализировано автоматически, минипорт-драйвер может вызывать WaitForTC в любое время, чтобы ждать завершения передачи DMA.
Так как этот метод просто ожидает завершения или истечения времени ожидания передачи DMA, вызовы WaitForTC должны выполняться в IRQL PASSIVE_LEVEL.
Требования
| Требование | Ценность |
|---|---|
| заголовка | portcls.h |
| IRQL | PASSIVE_LEVEL (см. раздел "Примечания".) |