NDK_FN_CREATE_PD 回调函数 (ndkpi)

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

语法

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,则会在此位置返回指向所创建的 PD 对象 (NDK_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_COMPLETION CreateCompletion 参数中指定的) 函数返回创建的对象。

要求

   
最低受支持的客户端 在 NDIS 6.30 和更高版本中不支持任何支持。
最低受支持的服务器 Windows Server 2012
目标平台 Windows
标头 ndkpi (包含 Ndkpi)
IRQL <= DISPATCH_LEVEL

请参阅

NDKPI 对象生存期要求

NDK_ADAPTER

NDK_ADAPTER_DISPATCH

NDK_FN_CREATE_COMPLETION

NDK_PD