RxCeAllocateIrpWithMDL-Funktion (rxce.h)

RxCeAllocateIrpWithMDL weist ein IRP zu und ordnet es einer vorhandenen Speicherbeschreibungsliste zu.

Syntax

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

Parameter

[in] StackSize

Die Stapelgröße, die für das IRP zugewiesen werden soll.

[in] ChargeQuota

Dieser Parameter sollte auf FALSE- durch Zwischentreiber festgelegt werden. Dies kann auf TRUE- nur durch Treiber der höchsten Ebene festgelegt werden, die im Kontext des Threads aufgerufen werden, der die E/A-Anforderung stammt, für die der Treiber ein anderes IRP angibt.

[in] Buffer

Ein Zeiger auf den Puffer, der die Speicherbeschreibungsliste enthält, die diesem IRP zugeordnet werden soll.

Rückgabewert

RxCeAllocateIrpWithMDL gibt einen Zeiger auf den IRP bei Erfolg oder einen NULL Zeiger auf Fehler zurück.

Bemerkungen

Ziel von RxCeAllocateIrpWithMDL- ist das einfachere Debuggen von IRPs, die für andere Komponenten ausgegeben werden und dann angehalten werden. IRPs, die mit RxCeAllocateIrpWithMDL- ausgegeben werden, werden in eine globale Liste von IRPs eingereiht, die von RDBSS verwaltet werden. Wenn also ein RX_CONTEXT auf einen Sendeabschluss wartet, ist es möglich, die globale Liste zu durchlaufen, um das IRP zu finden, das im Transport wartet.

Eine mit RxCeAllocateIrpWithMDL- zugeordnete IRP-Liste sollte freigegeben werden, wenn das IRP mit RxCeFreeIrpabgeschlossen ist.

IoAllocateIrp initialisiert automatisch die Mitglieder des IRP und fügt das IRP in eine globale Liste von IRPs ein, die von RDBSS verwaltet werden. Wenn speicher für die MDL, die dem IRP zugeordnet werden soll, nicht zugeordnet werden kann, wird der erstellte IRP freigegeben und RxCeAllocateIrpWithMDL gibt einen NULL- Zeiger zurück, der den Fehler angibt.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Die RxCeAllocateIrpWithMDL-Routine ist nur unter Windows XP verfügbar.
Zielplattform- Desktop
Header- rxce.h (include Rxce.h)
IRQL- <= APC_LEVEL

Siehe auch

MDL-

RxCeFreeIrp