Funzione RxCeAllocateIrpWithMDL (rxce.h)

  • Articolo

RxCeAllocateIrpWithMDL alloca un IRP e lo associa a un elenco di descrittori di memoria esistente.

Sintassi

PIRP RxCeAllocateIrpWithMDL(
  [in] IN CCHAR   StackSize,
  [in] IN BOOLEAN ChargeQuota,
  [in] IN PMDL    Buffer
);

Parametri

[in] StackSize

Dimensioni dello stack da allocare per l'IRP.

[in] ChargeQuota

Questo parametro deve essere impostato su FALSE dai driver intermedi. Questa impostazione può essere impostata su TRUE solo dai driver di livello più alto chiamati nel contesto del thread che ha origine la richiesta di I/O per cui il driver sta allocando un altro IRP.

[in] Buffer

Puntatore al buffer contenente l'elenco dei descrittori di memoria da associare a questo IRP.

Valore restituito

RxCeAllocateIrpWithMDL restituisce un puntatore all'IRP in caso di esito positivo o un puntatore NULL in caso di errore.

Commenti

L'obiettivo di RxCeAllocateIrpWithMDL è consentire un debug più semplice dei provider di integrazione rilasciati ad altri componenti e quindi bloccarsi. I provider di integrazione rilasciati con RxCeAllocateIrpWithMDL vengono accodati a un elenco globale di provider di integrazione gestiti da RDBSS. Pertanto, quando un RX_CONTEXT è in attesa di un completamento dell'invio, è possibile camminare l'elenco globale per trovare l'IRP in attesa nel trasporto.

Un IRP allocato con un elenco descrittore di memoria associato allocato con RxCeAllocateIrpWithMDL deve essere liberato quando l'IRP viene completato usando RxCeFreeIrp.

IoAllocateIrp inizializza automaticamente i membri di IRP e inserisce l'IRP in un elenco globale di provider di integrazione gestiti da RDBSS. Se non è possibile allocare memoria per MDL associato a IRP, l'IRP creato viene liberato e RxCeAllocateIrpWithMDL restituisce un puntatore NULL che indica un errore.

Requisiti

Requisito Valore
Client minimo supportato La routine RxCeAllocateIrpWithMDL è disponibile solo in Windows XP.
Piattaforma di destinazione Desktop
Intestazione rxce.h (include Rxce.h)
IRQL <= APC_LEVEL

Vedi anche

MDL

RxCeFreeIrp