RxCreateRxContext, fonction (rxcontx.h)
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 cette RX_CONTEXT et IRP s’appliquent.
[in] InitialContextFlags
Jeu de valeurs initiales pour les indicateurs de membre 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 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 de retour
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 retourner.
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 Indicateurs 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é.
Exigences
Exigence | Valeur |
---|---|
plateforme cible | Bureau |
d’en-tête | rxcontx.h (include Rxprocs.h rxcontx.h) |
IRQL | <= APC_LEVEL |
Voir aussi
RxDereferenceAndDeleteRxContext_Real
RxResumeBlockedOperations_Serially