NDK_FN_CREATE_COMPLETION función de devolución de llamada (ndkpi.h)

Artículo
02/07/2025

La función NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) completa la creación de un objeto NDK.

Sintaxis

NDK_FN_CREATE_COMPLETION NdkFnCreateCompletion;

void NdkFnCreateCompletion(
  [in, optional] PVOID Context,
  [in]           NTSTATUS Status,
  [in]           NDK_OBJECT_HEADER *pNdkObject
)
{...}

Parámetros

[in, optional] Context

Valor de contexto pasado al proveedor NDK cuando un consumidor llama a una función de creación de objetos. La función de creación proporciona el contexto con el puntero de función de la función NdkCreateCompletion NdkCreateCompletion (NDK_FN_CREATE_COMPLETION).

[in] Status

Estado de finalización asincrónica para la solicitud de creación. Vea las funciones de creación de objetos (por ejemplo, NDK_FN_CREATE_CQ) para obtener códigos de estado de finalización que se pueden devolver para cada tipo de objeto.

[in] pNdkObject

Puntero a un encabezado de objeto NDK (NDK_OBJECT_HEADER).

Valor devuelto

Ninguno

Observaciones

Nota Esta función la implementa el consumidor de NDK y se pasa al proveedor NDK.

Los objetos NDK se crean con funciones asincrónicas. Estas funciones de creación de objetos asincrónicas toman un puntero de función NDK_FN_CREATE_COMPLETION como parámetro de entrada.

Un proveedor NDK puede devolver STATUS_PENDING desde una función de creación de objetos asincrónica. En este caso, el proveedor NDK debe llamar a la función de finalización de creación para indicar que se ha completado la creación del objeto.

Cualquier otro código de estado indica la finalización insertada. En este caso, el proveedor no debe llamar a la función de finalización de la solicitud de creación. Si la función create request devuelve un código de estado de NT_STATUS distinto de STATUS_PENDING, el objeto creado debe devolverse en un parámetro de salida con la función create request.

Para las solicitudes de creación que devuelven STATUS_PENDING y posteriores se completan con STATUS_SUCCESS de forma asincrónica, el objeto creado debe devolverse mediante la función de finalización create con el parámetro pNdkObject y el proveedor no debe tener acceso al parámetro de salida del objeto de la función de solicitud de creación.

Requisitos

Requisito	Valor
cliente mínimo admitido	Ninguna compatible, compatible con NDIS 6.30 y versiones posteriores.
servidor mínimo admitido	Windows Server 2012
de la plataforma de destino de	Windows
encabezado de	ndkpi.h (incluya Ndkpi.h)
irQL	<=DISPATCH_LEVEL