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

另請參閱

RX_CONTEXT

RxCompleteRequest

RxCompleteRequest_Real

RxDereference

RxDereferenceAndDeleteRxContext_Real

RxInitializeContext

RxPrepareContextForReuse

RxResumeBlockedOperations_Serially

__RxSynchronizeBlockingOperations

__RxSynchronizeBlockingOperationsMaybeDroppingFcbLock