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 。 這隻能由在源自驅動程式配置另一個 IRP 之 I/O 要求的線程內容中呼叫的高階驅動程式設定為 TRUE 。

[in] Buffer

緩衝區的指標，其中包含要與此 IRP 相關聯的記憶體描述元清單。

傳回值

RxCeAllocateIrpWithMDL 會在成功時傳回 IRP 的指標，或在錯誤時傳回 NULL 指標。

備註

RxCeAllocateIrpWithMDL 的目標是允許更容易偵錯發出給其他元件的 IRP，然後停止。 使用 RxCeAllocateIrpWithMDL 發出的 IRP 會排入 RDBSS 維護的全域 IRP 清單。 因此，當RX_CONTEXT正在等候傳送完成時，可以逐步執行全域清單來尋找正在傳輸中等候的 IRP。

使用 RxCeFreeIrp 完成 IRP 時，應該釋放使用 RxCeAllocateIrpWithMDL 所配置的相關聯記憶體描述元清單的 IRP。

IoAllocateIrp 會自動初始化 IRP 的成員，並將 IRP 插入 RDBSS 所維護的全域 IRP 清單中。 如果無法配置與 IRP 相關聯的 MDL 記憶體，則會釋放所建立的 IRP，而 RxCeAllocateIrpWithMDL 會傳回 NULL 指標，指出失敗。

規格需求

另請參閱

MDL

RxCeFreeIrp