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

Artículo
02/26/2024

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 solicitud de finalización de creación asincrónica NdkCreateCompletion (NDK_FN_CREATE_COMPLETION).

[in] Status

Estado de finalización asincrónica de 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

None

Observaciones

Nota El consumidor de NDK implementa esta función 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 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 versiones 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	Value
Cliente mínimo compatible	Ninguno compatible, compatible con NDIS 6.30 y versiones posteriores.
Servidor mínimo compatible	Windows Server 2012
Plataforma de destino	Windows
Encabezado	ndkpi.h (incluya Ndkpi.h)
IRQL	<=DISPATCH_LEVEL