Funzione RxCreateRxContext (rxcontx.h)

Articolo
02/26/2024

RxCreateRxContext alloca una nuova struttura RX_CONTEXT e inizializza la struttura dei dati.

Sintassi

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

Parametri

[in, optional] Irp

Puntatore all'IRP da incapsulare da questa struttura RX_CONTEXT.

[in] RxDeviceObject

Puntatore all'oggetto dispositivo a cui si applica questa RX_CONTEXT e IRP.

[in] InitialContextFlags

Set di valori iniziali per il membro Flag della struttura di dati RX_CONTEXT da archiviare nella struttura RX_CONTEXT. Questi valori iniziali possono essere una combinazione delle enumerazioni seguenti:

RX_CONTEXT_FLAG_WAIT

Quando questo valore è impostato, l'IRP non deve essere pubblicato per l'esecuzione successiva del processo di file system, ma deve essere atteso per il completamento.

RX_CONTEXT_FLAG_MUST_SUCCEED

Quando questo valore è impostato, l'operazione deve avere esito positivo. Questo valore non è attualmente usato da RDBSS, ma può essere usato dai driver mini-redirector di rete.

RX_CONTEXT_FLAG_MUST_SUCCEED_NONBLOCKING

Quando questo valore è impostato, l'operazione deve avere esito positivo per le operazioni non bloccate. Questo valore non è attualmente usato da RDBSS, ma può essere usato dai driver mini-redirector di rete.

Valore restituito

RxCreateRxContext restituisce un puntatore a una struttura di dati allocata RX_CONTEXT in caso di esito positivo o di un puntatore NULL in caso di errore.

Commenti

RxCreateRxContext chiama RxInitializeContext per inizializzare la struttura di RX_CONTEXT appena creata prima di restituire.

RxCreateRxContext alloca memoria del pool non a pagina quando si crea una nuova struttura di dati RX_CONTEXT e imposta il valore seguente nel membro Flags del RX_CONTEXT:

Quando questo valore viene impostato, la struttura RX_CONTEXT è stata allocata dalla memoria del pool non a pagina.