RxCreateRxContext-Funktion (rxcontx.h)

Artikel
02/07/2025

RxCreateRxContext eine neue RX_CONTEXT Struktur zuordnet und die Datenstruktur initialisiert.

Syntax

PRX_CONTEXT RxCreateRxContext(
  [in, optional] IN PIRP                 Irp,
  [in]           IN PRDBSS_DEVICE_OBJECT RxDeviceObject,
  [in]           IN ULONG                InitialContextFlags
);

Parameter

[in, optional] Irp

Ein Zeiger auf das IRP, das von dieser RX_CONTEXT Struktur gekapselt werden soll.

[in] RxDeviceObject

Ein Zeiger auf das Geräteobjekt, auf das dieses RX_CONTEXT und IRP angewendet wird.

[in] InitialContextFlags

Die Gruppe der Anfangswerte für die Flags Element der RX_CONTEXT Datenstruktur, die in der RX_CONTEXT-Struktur gespeichert werden soll. Diese Anfangswerte können eine beliebige Kombination der folgenden Enumerationen sein:

RX_CONTEXT_FLAG_WAIT

Wenn dieser Wert festgelegt ist, sollte das IRP nicht für die spätere Ausführung durch den Dateisystemprozess bereitgestellt werden, sondern auf den Abschluss gewartet werden.

RX_CONTEXT_FLAG_MUST_SUCCEED

Wenn dieser Wert festgelegt ist, muss der Vorgang erfolgreich ausgeführt werden. Dieser Wert wird derzeit nicht von RDBSS verwendet, kann jedoch von Netzwerk-Miniumleitungstreibern verwendet werden.

RX_CONTEXT_FLAG_MUST_SUCCEED_NONBLOCKING

Wenn dieser Wert festgelegt ist, muss der Vorgang für nicht blockierende Vorgänge erfolgreich sein. Dieser Wert wird derzeit nicht von RDBSS verwendet, kann jedoch von Netzwerk-Miniumleitungstreibern verwendet werden.

Rückgabewert

RxCreateRxContext- gibt einen Zeiger auf eine zugeordnete RX_CONTEXT Datenstruktur für Erfolg oder einen NULL Zeiger beim Fehler zurück.

Bemerkungen

RxCreateRxContext ruftRxInitializeContext- auf, um die neu erstellte RX_CONTEXT Struktur zu initialisieren, bevor sie zurückgegeben wird.

RxCreateRxContext weist beim Erstellen einer neuen RX_CONTEXT Datenstruktur nicht ausgelagerten Poolspeicher zu und legt den folgenden Wert im Flags-Element der RX_CONTEXT fest:

Wenn dieser Wert festgelegt ist, wurde die RX_CONTEXT Struktur aus nicht ausgelagerten Poolspeichern zugewiesen.