RxCreateRxContext-Funktion (rxcontx.h)

Artikel
02/26/2024

RxCreateRxContext weist eine neue RX_CONTEXT-Struktur zu und initialisiert die Datenstruktur.

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 den IRP, der von dieser RX_CONTEXT-Struktur gekapselt werden soll.

[in] RxDeviceObject

Ein Zeiger auf das Geräteobjekt, auf das diese RX_CONTEXT und IRP angewendet werden.

[in] InitialContextFlags

Der Satz von Anfangswerten für den Flags-Member 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 der IRP nicht zur späteren Ausführung durch den Dateisystemprozess bereitgestellt, sondern auf den Abschluss gewartet werden.

RX_CONTEXT_FLAG_MUST_SUCCEED

Wenn dieser Wert festgelegt ist, muss der Vorgang erfolgreich sein. Dieser Wert wird derzeit nicht von RDBSS verwendet, kann aber 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 aber von Netzwerk-Miniumleitungstreibern verwendet werden.

Rückgabewert

RxCreateRxContext gibt einen Zeiger auf eine zugeordnete RX_CONTEXT Datenstruktur bei Erfolg oder einen NULL-Zeiger bei Einem Fehler zurück.

Hinweise

RxCreateRxContext ruft RxInitializeContext auf, um die neu erstellte RX_CONTEXT-Struktur vor der Rückgabe zu initialisieren.

RxCreateRxContext weist nicht ausgelagerten Poolspeicher zu, wenn eine neue RX_CONTEXT-Datenstruktur erstellt wird, und legt den folgenden Wert im Flags-Member des RX_CONTEXT fest:

Wenn dieser Wert festgelegt ist, wurde die RX_CONTEXT-Struktur aus dem Nicht-Auslagerungspoolspeicher zugeordnet.