WdfMemoryCreateFromLookaside 函数 (wdfmemory.h)

  • 项目

[仅适用于 KMDF]

WdfMemoryCreateFromLookaside 方法创建框架内存对象，并从指定的 lookaside 列表中获取内存缓冲区。

语法

NTSTATUS WdfMemoryCreateFromLookaside(
  [in]  WDFLOOKASIDE Lookaside,
  [out] WDFMEMORY    *Memory
);

参数

[in] Lookaside

通过调用 WdfLookasideListCreate 获取的框架 lookaside-list 对象的句柄。

[out] Memory

指向接收新框架内存对象的句柄的位置的指针。

返回值

如果操作成功，WdfMemoryCreateFromLookaside 将返回STATUS_SUCCESS。 否则，此方法返回以下值之一：

返回代码 说明
STATUS_INVALID_PARAMETER
 检测到参数无效。
STATUS_INSUFFICIENT_RESOURCES
 内存不足。
 

此方法还可能返回其他 NTSTATUS 值。

如果驱动程序提供无效的对象句柄，则会发生 bug 检查。

注解

在驱动程序调用 WdfLookasideListCreate 来创建 lookaside-list 对象后，驱动程序可以调用 WdfMemoryCreateFromLookaside 从 lookaside 列表中获取缓冲区。

框架为表示缓冲区的内存对象提供句柄。 当框架创建内存对象时，它使用驱动程序在调用 WdfMemoryCreateFromLookaside 时提供的对象属性。

当驱动程序使用完从 lookaside 列表中获取的内存对象时，驱动程序必须调用 WdfObjectDelete ，以便将内存对象返回到 lookaside 列表。

有关框架内存对象和旁观列表的详细信息，请参阅 使用内存缓冲区。

如果从可分页内存池分配 lookaside-list 缓冲区，则必须在 IRQL <= APC_LEVEL调用 WdfMemoryCreateFromLookaside 方法。 否则，可以在 IRQL <= DISPATCH_LEVEL 调用 方法。

示例

下面的代码示例创建一个旁观列表，并将列表的句柄存储在驱动程序定义的设备对象上下文空间中。 然后，驱动程序从旁视列表中获取缓冲区。

PDRIVER_CONTEXT  driverContext;
WDFMEMORY  memHandle;

driverContext = GetDriverContext(driver);

status = WdfLookasideListCreate(
                                WDF_NO_OBJECT_ATTRIBUTES,
                                sizeof(MY_LOOKASIDE_BUFFER),
                                NonPagedPool,
                                WDF_NO_OBJECT_ATTRIBUTES,
                                MY_POOL_TAG,
                                &driverContext->LookasideListHandle
                                );
...
status = WdfMemoryCreateFromLookaside(
                                      driverContext->LookasideListHandle,
                                      &memHandle
                                      );

要求

要求 值
目标平台 通用
最低 KMDF 版本 1.0
标头 wdfmemory.h (包括 Wdf.h)
Library Wdf01000.sys (请参阅框架库 Versioning.)
IRQL 请参见“备注”部分。
DDI 符合性规则 DriverCreate (kmdf)

另请参阅

WdfLookasideListCreate

WdfMemoryCreate

WdfMemoryCreatePreallocated

WdfObjectDelete