PcDispatchIrp 函式 (portcls.h)
PcDispatchIrp 函式會將 IRP 分派至 PortCls 系統驅動程式的預設處理程式。
語法
PORTCLASSAPI NTSTATUS PcDispatchIrp(
[in] PDEVICE_OBJECT pDeviceObject,
[in] PIRP pIrp
);
參數
[in] pDeviceObject
裝置物件的指標。 此參數必須指向類型為 DEVICE_OBJECT的系統結構。
[in] pIrp
要分派之 IRP 的指標
傳回值
如果呼叫成功,PcDispatchIrp 會傳回STATUS_SUCCESS。 否則,它會傳回適當的錯誤碼。
言論
在初始化過程中,PcInitializeAdapterDriver 函式會將數個 IRP 的處理程式指標載入驅動程式物件。 在呼叫 PcInitializeAdapterDriver之後,配接器驅動程式可以選擇覆寫一或多個 PortCls 處理程式指標,並將指標指向自己的 IRP 處理程式。
如果在收到 IRP 之後,配接器驅動程式的 IRP 處理程式會決定應該由 PortCls IRP 處理程式處理 IRP,配接器驅動程式的處理程式會呼叫 PcDispatchIrp,將 IRP 轉送至 PortCls 處理程式。
如需程式代碼範例,請參閱 Microsoft Windows 驅動程式套件 (WDK) 中的 SB16 範例音訊驅動程式。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | PortCls 系統驅動程式會在 Microsoft Windows 98/Me 和 Windows 2000 和更新版本的作系統中實作 PcDispatchIrp 函式。 |
目標平臺 | 普遍 |
標頭 | portcls.h |
連結庫 | Portcls.lib |
IRQL | PASSIVE_LEVEL |