Funzione PcDispatchIrp (portcls.h)
La funzione PcDispatchIrp invia un'IRP al gestore predefinito del driver di sistema PortCls.
Sintassi
PORTCLASSAPI NTSTATUS PcDispatchIrp(
[in] PDEVICE_OBJECT pDeviceObject,
[in] PIRP pIrp
);
Parametri
[in] pDeviceObject
Puntatore all'oggetto dispositivo. Questo parametro deve puntare a una struttura di sistema di tipo DEVICE_OBJECT.
[in] pIrp
Puntatore all'IRP da inviare
Valore restituito
PcDispatchIrp restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.
Commenti
Nell'ambito del processo di inizializzazione, la funzione PcInitializeAdapterDriver carica i puntatori ai gestori per diversi INDIRIZZI DI ACCESSO nell'oggetto driver. Dopo la chiamata a PcInitializeAdapterDriver, un driver dell'adapter può scegliere di sovrascrivere uno o più puntatori del gestore PortCls con puntatori ai propri gestori IRP.
Se, dopo aver ricevuto un'IRP, il gestore IRP del driver dell'adapter determina che l'IRP deve essere gestito dal gestore IRP PortCls, il gestore dell'adapter chiama invece PcDispatchIrp per inoltrare l'IRP al gestore PortCls.
Per un esempio di codice, vedere il driver audio di esempio SB16 in Microsoft Windows Driver Kit (WDK).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Il driver di sistema PortCls implementa la funzione PcDispatchIrp in Microsoft Windows 98/Me e nei sistemi operativi Windows 2000 e versioni successive. |
| Piattaforma di destinazione | Universale |
| Intestazione | portcls.h |
| Libreria | Portcls.lib |
| IRQL | PASSIVE_LEVEL |