共用方式為


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

另請參閱

RX_CONTEXT

RxCompleteRequest

RxCompleteRequest_Real

RxDereference

RxDereferenceAndDeleteRxContext_Real

RxInitializeContext

RxPrepareContextForReuse

RxResumeBlockedOperations_Serially

__RxSynchronizeBlockingOperations

__RxSynchronizeBlockingOperationsMaybeDroppingFcbLock