RxAcquireSharedFcbResourceInMRx 函数 (mrxfcb.h)

项目
02/26/2024

RxAcquireSharedFcbResourceInMRx 获取共享模式下网络微型重定向程序驱动程序的 FCB 资源。如果 FCB 资源以前是独占获取的，则此例程将等待其释放，并且不会在获取共享资源之前返回控制权。

语法

NTSTATUS RxAcquireSharedFcbResourceInMRx(
  PMRX_FCB Fcb
);

参数

Fcb

指向 FCB 的指针。此参数是必需的，不能为 NULL。

返回值

RxAcquireSharedFcbResourceInMRx 在成功时返回STATUS_SUCCESS或在失败时返回以下错误代码之一：

返回代码	说明
STATUS_LOCK_NOT_GRANTED	未获取 FCB 资源。
STATUS_CANCELLED	与 FCB 关联的RX_CONTEXT已取消。

注解

与网络微型重定向程序驱动程序相关的同步资源主要与 FCB 相关联。有一个分页 I/O 资源和一个常规资源。分页 I/O 资源由 RDBSS 内部管理。网络微型重定向程序驱动程序可访问的唯一资源是应使用 RxAcquireExclusiveFcbResourceInMRx、 RxAcquireExclusiveFcbResourceInMRxEx 或 RxAcquireSharedFcbResourceInMRx 访问的常规资源，具体取决于所需的获取模式。

如果 FCB 资源以前是独占获取的，则 RxAcquireSharedFcbResourceInMRx 将等待 FCB 资源可用，并且直到获取共享资源后才会返回控制权。即使已取消与此 FCB 关联的RX_CONTEXT，此例程也会获取 FCB 资源。

应通过调用 RxReleaseFcbResourceInMRx 或 RxReleaseFcbResourceForThreadInMRx 释放使用 RxAcquireSharedFcbResourceInMRx 获取的 FCB 资源。