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 al 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.
Osservazioni
Come parte del processo di inizializzazione, la funzione PcInitializeAdapterDriver carica i puntatori ai gestori per diversi runtime di integrazione nell'oggetto driver. Dopo la chiamata a PcInitializeAdapterDriver, un driver di adattatore 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'adattatore determina che l'IRP deve essere gestito dal gestore IRP portCls, il gestore del driver dell'adattatore chiama 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).
Fabbisogno
| 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 |