WdfMemoryCreateFromLookaside 函数 （wdfmemory.h）

[仅适用于 KMDF]

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

语法

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

参数

[in] Lookaside

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

[out] Memory

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

返回值

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

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

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

注解

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

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

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

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

如果要从可分页内存池分配 lookaside 列表缓冲区，则必须在 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
                                      );

要求

另请参阅

WdfLookasideListCreate

WdfMemoryCreate

WdfMemoryCreatePreallocated

WdfObjectDelete