RxCeAllocateIrpWithMDL 函式 (rxce.h)
RxCeAllocateIrpWithMDL 配置 IRP,並將它與現有的記憶體描述元清單產生關聯。
語法
PIRP RxCeAllocateIrpWithMDL(
[in] IN CCHAR StackSize,
[in] IN BOOLEAN ChargeQuota,
[in] IN PMDL Buffer
);
參數
[in] StackSize
要配置給 IRP 的堆疊大小。
[in] ChargeQuota
此參數應該設定為中繼驅動程式 FALSE。 這可以設定為 TRUE,而此驅動程式只能在產生驅動程式配置另一個 IRP 之 I/O 要求的線程內容中呼叫的最高層級驅動程式。
[in] Buffer
緩衝區的指標,其中包含要與此 IRP 相關聯的記憶體描述元清單。
傳回值
RxCeAllocateIrpWithMDL 會在成功時傳回 IRP 的指標,或發生錯誤的 NULL 指標。
言論
RxCeAllocateIrpWithMDL 的目標是允許更容易偵錯發出給其他元件的 IRP,然後停止。 使用 RxCeAllocateIrpWithMDL 發出的 IRP 會排入 RDBSS 維護的全域 IRP 清單。 因此,當RX_CONTEXT正在等候傳送完成時,可以逐步執行全域清單來尋找在傳輸中等候的 IRP。
使用 RxCeFreeIrp 完成 IRP 時,應該釋出配置與 RxCeAllocateIrpWithMDL 相關聯的記憶體描述元清單。
IoAllocateIrp 會自動初始化 IRP 的成員,並將 IRP 插入 RDBSS 維護的全域 IRP 清單中。 如果無法配置與 IRP 相關聯的 MDL 記憶體,則會釋放所建立的 IRP,RxCeAllocateIrpWithMDL 會傳回指出失敗 NULL 指標。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | RxCeAllocateIrpWithMDL 例程僅適用於 Windows XP。 |
目標平臺 | 桌面 |
標頭 | rxce.h (包括 Rxce.h) |
IRQL | <= APC_LEVEL |