RxCreateRxContext, fonction (rxcontx.h)

Article
02/29/2024

RxCreateRxContext alloue une nouvelle structure RX_CONTEXT et initialise la structure de données.

Syntaxe

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

Paramètres

[in, optional] Irp

Pointeur vers l’IRP à encapsuler par cette structure RX_CONTEXT.

[in] RxDeviceObject

Pointeur vers l’objet d’appareil auquel s’appliquent cette RX_CONTEXT et IRP.

[in] InitialContextFlags

Ensemble de valeurs initiales pour le membre Flags de la structure de données RX_CONTEXT à stocker dans la structure RX_CONTEXT. Ces valeurs initiales peuvent être n’importe quelle combinaison des énumérations suivantes :

RX_CONTEXT_FLAG_WAIT

Lorsque cette valeur est définie, l’IRP ne doit pas être publié pour une exécution ultérieure par le processus du système de fichiers, mais doit être attendu pour se terminer.

RX_CONTEXT_FLAG_MUST_SUCCEED

Lorsque cette valeur est définie, l’opération doit réussir. Cette valeur n’est actuellement pas utilisée par RDBSS, mais elle peut être utilisée par les pilotes de mini-redirecteur réseau.

RX_CONTEXT_FLAG_MUST_SUCCEED_NONBLOCKING

Lorsque cette valeur est définie, l’opération doit réussir pour les opérations non bloquantes. Cette valeur n’est actuellement pas utilisée par RDBSS, mais elle peut être utilisée par les pilotes de mini-redirecteur réseau.

Valeur retournée

RxCreateRxContext retourne un pointeur vers une structure de données RX_CONTEXT allouée en cas de réussite ou un pointeur NULL en cas d’échec.

Remarques

RxCreateRxContext appelle RxInitializeContext pour initialiser la structure RX_CONTEXT nouvellement créée avant de revenir.

RxCreateRxContext alloue de la mémoire de pool non paginée lors de la création d’une structure de données RX_CONTEXT et définit la valeur suivante dans le membre Flags du RX_CONTEXT :

Lorsque cette valeur est définie, la structure RX_CONTEXT a été allouée à partir de la mémoire du pool non paginée.