通过

NDK_FN_CREATE_MW回调函数 （ndkpi.h）

  • 项目

NdkCreateMw （NDK_FN_CREATE_MW） 函数创建 NDK 内存窗口 （MW） 对象。

语法

NDK_FN_CREATE_MW NdkFnCreateMw;

NTSTATUS NdkFnCreateMw(
  [in]           NDK_PD *pNdkPd,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_MW **ppNdkMw
)
{...}

参数

[in] pNdkPd

指向 NDK 保护域 （PD） 对象的指针（NDK_PD）。

[in] CreateCompletion

指向完成 NDK 对象的创建 NdkCreateCompletion（NDK_FN_CREATE_COMPLETION）函数的指针。

[in, optional] RequestContext

NDK 提供程序传回 NdkCreateCompletion 函数的上下文值，该函数是在 createCompletion 参数中指定的。

ppNdkMw

如果请求成功而不返回STATUS_PENDING，则会在此位置返回指向已创建的MW 对象的指针（NDK_MW）。 如果请求返回STATUS_PENDING，则忽略此参数，并使用 CreateCompletion 参数中指定的回调返回创建的对象。

返回值

NdkCreateMw 函数返回以下 NTSTATUS 代码之一。

返回代码 描述
STATUS_SUCCESS
 MW 对象已成功创建，并使用 *ppNdkMw 参数返回。
STATUS_PENDING
 该作处于挂起状态，稍后将完成。 提供程序将调用 CreateCompletion 参数（NDK_FN_CREATE_COMPLETION）中指定的函数来完成挂起的作。
STATUS_INSUFFICIENT_RESOURCES
 请求由于资源不足而失败。
重要 请求可以内联失败，以及使用此状态代码异步失败。
 
其他状态代码
 发生错误。

言论

NdkCreateMw 函数创建可用于绑定请求的 NDK 内存窗口 （MW） 对象。 如果函数返回STATUS_SUCCESS，则会在 ppNdkMw 参数中返回创建的对象。 如果 NdkCreateMw 返回STATUS_PENDING，则创建的对象由 CreateCompletion 参数中指定的 NdkCreateCompletion （NDK_FN_CREATE_COMPLETION） 函数返回。

要求

要求 价值
最低支持的客户端 NDIS 6.30 及更高版本不支持。
支持的最低服务器 Windows Server 2012
目标平台 窗户
标头 ndkpi.h （包括 Ndkpi.h）
IRQL <=DISPATCH_LEVEL

另请参阅

NDKPI 对象生存期要求

NDK_FN_CREATE_COMPLETION

NDK_MW

NDK_PD