Funzione PcForwardIrpSynchronous (portcls.h)
La funzione PcForwardIrpSynchronous viene usata dai gestori di IRP per inoltrare Plug and Play IRP all'oggetto dispositivo fisico (PDO).
Sintassi
PORTCLASSAPI NTSTATUS PcForwardIrpSynchronous(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
Parametri
[in] DeviceObject
Puntatore all'oggetto dispositivo del dispositivo audio. Questo parametro deve puntare a una struttura di sistema di tipo DEVICE_OBJECT.
[in] Irp
Puntatore all'IRP che deve essere inoltrato
Valore restituito
PcForwardIrpSynchronous restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.
Commenti
PcForwardIrpSynchronous fa sì che il pdo successivo riceva l'IRP e il blocco fino al completamento dell'IRP dal driver di dispositivo fisico. A quel punto , PcForwardIrpSynchronous sblocca e torna al chiamante. Il chiamante (un gestore IRP) deve eventualmente restituire, possibilmente con uno stato di STATUS_PENDING. In generale, qualsiasi gestore IRP che chiama questa funzione deve specificare l'azione IRP_ACTION_FINISH al momento della restituzione. Qualsiasi altra azione comporterà l'inoltro dell'IRP al dispositivo fisico una seconda volta.
La funzione PcCompleteIrp viene usata quando un gestore IRP restituisce STATUS_PENDING e l'IRP deve essere completato in un secondo momento.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Il driver di sistema PortCls implementa la funzione PcForwardIrpSynchronous in Microsoft Windows 98/Me e nei sistemi operativi Windows 2000 e versioni successive. |
| Piattaforma di destinazione | Universale |
| Intestazione | portcls.h (include Portcls.h) |
| Libreria | Portcls.lib |
| IRQL | PASSIVE_LEVEL |