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

Vedi anche

DEVICE_OBJECT

IRP

PcInitializeAdapterDriver