Funzione PcForwardIrpSynchronous (portcls.h)

La funzione PcForwardIrpSynchronous viene usata dai gestori IRP per inoltrare i runtime di integrazione Plug and Play al 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 al IRP da inoltrare

Valore restituito

pcForwardIrpSynchronous restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato.

Osservazioni

PcForwardIrpSynchronous fa sì che il pdo successivo riceva l'IRP e il blocco finché l'IRP non è stato completato dal driver di dispositivo fisico. A questo punto, PcForwardIrpSynchronous sblocca e torna al chiamante. Il chiamante (un gestore IRP) dovrebbe restituire eventualmente 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 comporta 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.

Fabbisogno

Vedere anche

DEVICE_OBJECT

IRP

PcCompleteIrp