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 (include Rxprocs.h rxcontx.h) |
IRQL | <= APC_LEVEL |
另請參閱
RxDereferenceAndDeleteRxContext_Real
RxResumeBlockedOperations_Serially