Compartir a través de

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

  • Artículo

La función NdkCloseObject (NDK_FN_CLOSE_OBJECT) inicia una solicitud de cierre para un objeto NDK.

Sintaxis

NDK_FN_CLOSE_OBJECT NdkFnCloseObject;

NTSTATUS NdkFnCloseObject(
  [in]           NDK_OBJECT_HEADER *pNdkObject,
  [in]           NDK_FN_CLOSE_COMPLETION CloseCompletion,
  [in, optional] PVOID RequestContext
)
{...}

Parámetros

[in] pNdkObject

Puntero al encabezado del objeto (NDK_OBJECT_HEADER) para que se cierre el objeto.

[in] CloseCompletion

Puntero a una función de devolución de llamada de finalización de cierre de NdkCloseCompletion (NDK_FN_CLOSE_COMPLETION).

[in, optional] RequestContext

Valor de contexto para que el proveedor NDK vuelva a la función NdkCloseCompletion especificada en el parámetro CloseCompletion .

Valor devuelto

La función NdkCloseObject devuelve uno de los siguientes códigos NTSTATUS.

Código devuelto Descripción
STATUS_SUCCESS
 El objeto NDK está cerrado. El proveedor no llamará a la función NdkCloseCompletion .
STATUS_PENDING
 La solicitud está pendiente, el proveedor llamará a la función NdkCloseCompletion para completar la operación de forma asincrónica. La solicitud de cierre se ha iniciado correctamente, pero es posible que no se complete.
Otros códigos de estado
 Se produjo un error.

Comentarios

La tabla de distribución de funciones para cada tipo de objeto NDK incluye un puntero de función NDK_FN_CLOSE_OBJECT . Las solicitudes de cierre son asincrónicas. Un consumidor de NDK no debe tener acceso al objeto después de iniciar una solicitud de cierre.

El proveedor NDK debe asegurarse de que la función NdkCloseCompletion (NDK_FN_CLOSE_COMPLETION) es la última devolución de llamada a la que se llama para el objeto que está cerrando. El proveedor debe asegurarse de que se completen todas las solicitudes asincrónicas pendientes y que todas las devoluciones de llamada en curso se hayan devuelto y se impidan más devoluciones de llamada antes de que el proveedor llame a la función NdkCloseCompletion . Una vez que el proveedor llama a la función NdkCloseCompletion , el proveedor no llama a ninguna función de finalización ni funciones de devolución de llamada de notificación para el objeto.

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

Consulte también

Requisitos de duración del objeto NDKPI

NDK_CONNECTOR_DISPATCH

NDK_CQ_DISPATCH

NDK_FN_CLOSE_COMPLETION

NDK_OBJECT_HEADER