NDK_FN_CREATE_PD - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers 
// ndkpi.h

NDK_FN_CREATE_PD NdkFnCreatePd;

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

View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Edit description on GitHub

Windows Driver Kit DDI reference (nc-ndkpi-ndk_fn_create_pd)

NDK_FN_CREATE_PD callback function

Description

The NdkCreatePd (NDK_FN_CREATE_PD) function creates an NDK protection domain (PD) object.

Parameters

pNdkAdapter [in]

A pointer to an NDK adapter object (NDK_ADAPTER).

CreateCompletion [in]

A pointer to an NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) function that completes the creation of an NDK object.

RequestContext [in, optional]

A context value that the NDK provider passes back to the NdkCreateCompletion function that is specified in the CreateCompletion parameter.

ppNdkPd

A pointer to a created PD object (NDK_PD) is returned in this location if the request succeeds without returning STATUS_PENDING. If the request returns STATUS_PENDING then this parameter is ignored and the created object is returned with the callback that is specified in the CreateCompletion parameter.

Return value

The NdkCreatePd function returns one of the following NTSTATUS codes.

Return code Description
STATUS_SUCCESS The PD object was created successfully and returned with the *ppNdkPd parameter.
STATUS_PENDING The operation is pending and will be completed later. The provider will call the function specified in the CreateCompletion parameter(NDK_FN_CREATE_COMPLETION) to complete the pending operation.
STATUS_INSUFFICIENT_RESOURCES The request failed due to insufficient resources.

Important The request can fail inline as well as asynchronously with this status code.
Other status codes An error occurred.

Remarks

The NdkCreatePd function creates an NDK protection domain (PD) object. If the function returns STATUS_SUCCESS, the created object is returned in the ppNdkPd parameter. If NdkCreatePd returns STATUS_PENDING, the created object is returned by the NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) function that is specified in the CreateCompletion parameter.

See also

NDKPI Object Lifetime Requirements

NDK_ADAPTER

NDK_ADAPTER_DISPATCH

NDK_FN_CREATE_COMPLETION

NDK_PD

View the official Windows Driver Kit DDI reference

Edit description on GitHub