Funzione PcCompleteIrp (portcls.h)
La funzione PcCompleteIrp completa un'IRP contrassegnata in precedenza come in sospeso.
Sintassi
PORTCLASSAPI NTSTATUS PcCompleteIrp(
[in] PDEVICE_OBJECT pDeviceObject,
[in] PIRP pIrp,
[in] NTSTATUS ntStatus
);
Parametri
[in] pDeviceObject
Puntatore all'oggetto dispositivo per il dispositivo. Questo parametro deve puntare a una struttura di sistema di tipo DEVICE_OBJECT.
[in] pIrp
Puntatore all'IRP da completare
[in] ntStatus
Specifica lo stato dell'IRP completato. Vedere l'elenco dei valori NTSTATUS definiti nel file di intestazione ntstatus.h.
Valore restituito
PcCompleteIrp restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.
Commenti
PcCompleteIrp viene usato quando un gestore IRP restituisce STATUS_PENDING e l'IRP deve essere completato in un secondo momento. Al termine dell'elaborazione dell'IRP, il driver dell'adattatore chiama PcCompleteIrp per completare l'IRP.
Il gestore IRP non deve chiamare questa funzione. Il gestore IRP di un driver della scheda chiama invece PcDispatchIrp per passare l'IRP al gestore IRP del driver di sistema PortCls per eseguire tutte le operazioni rimanenti di elaborazione dell'IRP.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Il driver di sistema PortCls implementa la funzione PcCompleteIrp in Microsoft Windows 98/Me e nei sistemi operativi Windows 2000 e versioni successive. |
| Piattaforma di destinazione | Universale |
| Intestazione | portcls.h (includere Portcls.h) |
| Libreria | Portcls.lib |
| IRQL | <=DISPATCH_LEVEL |