Функция PcCompleteIrp (portcls.h)
Функция PcCompleteIrp завершает IRP, который ранее был помечен как ожидающий.
Синтаксис
PORTCLASSAPI NTSTATUS PcCompleteIrp(
[in] PDEVICE_OBJECT pDeviceObject,
[in] PIRP pIrp,
[in] NTSTATUS ntStatus
);
Параметры
[in] pDeviceObject
Указатель на объект устройства. Этот параметр должен указывать на системную структуру типа DEVICE_OBJECT.
[in] pIrp
Указатель на IRP, который должен быть завершен
[in] ntStatus
Указывает состояние завершенного IRP. См. список значений NTSTATUS, определенных в файле заголовка ntstatus.h.
Возвращаемое значение
PcCompleteIrp возвращает STATUS_SUCCESS, если вызов выполнен успешно. В противном случае возвращается соответствующий код ошибки.
Замечания
PcCompleteIrp используется, когда обработчик IRP возвращает STATUS_PENDING, а IRP должен быть завершен позже. Когда драйвер адаптера завершит обработку IRP, он вызывает PcCompleteIrp для завершения IRP.
Обработчик IRP не должен вызывать эту функцию. Обработчик IRP драйвера адаптера вместо этого вызывает PcDispatchIrp передать IRP обработчику IRP системы PortCls, чтобы выполнить всю оставшуюся обработку IRP.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Системный драйвер PortCls реализует функцию PcCompleteIrp в Microsoft Windows 98/Me и в Операционных системах Windows 2000 и более поздних версий. |
| целевая платформа | Всеобщий |
| заголовка | portcls.h (include Portcls.h) |
| библиотеки | Portcls.lib |
| IRQL | <=DISPATCH_LEVEL |