RxCreateRxContext 函式 (rxcontx.h)
RxCreateRxContext 會配置新的RX_CONTEXT結構,並初始化數據結構。
語法
PRX_CONTEXT RxCreateRxContext(
[in, optional] IN PIRP Irp,
[in] IN PRDBSS_DEVICE_OBJECT RxDeviceObject,
[in] IN ULONG InitialContextFlags
);
參數
[in, optional] Irp
這個RX_CONTEXT結構所封裝之 IRP 的指標。
[in] RxDeviceObject
套用這個RX_CONTEXT和 IRP 之裝置物件的指標。
[in] InitialContextFlags
要儲存在RX_CONTEXT結構中之RX_CONTEXT數據結構的 Flags 成員的初始值集。 這些初始值可以是下列列舉的任何組合:
RX_CONTEXT_FLAG_WAIT
設定此值時,不應該張貼 IRP 以供文件系統進程稍後執行,但應該等候完成。
RX_CONTEXT_FLAG_MUST_SUCCEED
設定此值時,作業必須成功。 RDBSS 目前未使用此值,但網路迷你重新導向器驅動程式可能使用它。
RX_CONTEXT_FLAG_MUST_SUCCEED_NONBLOCKING
設定此值時,非封鎖作業的作業必須成功。 RDBSS 目前未使用此值,但網路迷你重新導向器驅動程式可能使用它。
傳回值
RxCreateRxContext 會在成功時傳回已配置RX_CONTEXT數據結構的指標,或在失敗時傳回 NULL 指標。
備註
RxCreateRxContext 會呼叫 RxInitializeContext ,以在傳回之前初始化新建立RX_CONTEXT結構。
RxCreateRxContext 會在建立新的RX_CONTEXT數據結構時配置非分頁集區內存,並在 RX_CONTEXT 的 Flags 成員中設定下列值:
設定此值時,會從非分頁集區內存配置RX_CONTEXT結構。
規格需求
需求 | 值 |
---|---|
目標平台 | 桌面 |
標頭 | rxcontx.h (包含 Rxprocs.h rxcontx.h) |
IRQL | <= APC_LEVEL |
另請參閱
RxDereferenceAndDeleteRxContext_Real
RxResumeBlockedOperations_Serially