NDK_FN_CREATE_PD回调函数 (ndkpi.h)

NdkCreatePd (NDK_FN_CREATE_PD) 函数 (PD) 对象创建 NDK 保护域。

语法

NDK_FN_CREATE_PD NdkFnCreatePd;

NTSTATUS NdkFnCreatePd(
  [in]           NDK_ADAPTER *pNdkAdapter,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_PD **ppNdkPd
)
{...}

参数

[in] pNdkAdapter

指向 NDK 适配器对象的指针 (NDK_ADAPTER) 。

[in] CreateCompletion

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

[in, optional] RequestContext

NDK 提供程序传递回 CreateCompletion 参数中指定的 NdkCreateCompletion 函数的上下文值。

ppNdkPd

如果请求成功，但未返回 STATUS_PENDING ，则此位置将返回 (NDK_PD) 创建的 PD 对象的指针。 如果请求返回STATUS_PENDING则忽略此参数，并使用 CreateCompletion 参数中指定的回调返回创建的对象。

返回值

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

返回代码	说明
STATUS_SUCCESS	PD 对象已成功创建，并返回了 *ppNdkPd 参数。
STATUS_PENDING	操作处于挂起状态，稍后将完成。 提供程序将调用 CreateCompletion 参数中指定的函数 (NDK_FN_CREATE_COMPLETION) 来完成挂起的操作。
STATUS_INSUFFICIENT_RESOURCES	由于资源不足，请求失败。 重要 请求可能会内联失败，也可能会以异步方式失败，并显示此状态代码。
其他状态代码	出现了错误。

注解

NdkCreatePd 函数 (PD) 对象创建 NDK 保护域。 如果函数返回STATUS_SUCCESS，则会在 ppNdkPd 参数中返回创建的对象。 如果 NdkCreatePd 返回STATUS_PENDING，则创建的 对象由 NdkCreateCompletion (NDK_FN_CREATE_COMPLETIONcreateCompletion 参数中指定的) 函数返回。

要求

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

另请参阅

NDKPI 对象生存期要求

NDK_ADAPTER

NDK_ADAPTER_DISPATCH

NDK_FN_CREATE_COMPLETION

NDK_PD