NDK_FN_CLOSE_OBJECT función de devolución de llamada (ndkpi.h)
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 un NdkCloseCompletion cerrar la función de devolución de llamada de finalización (NDK_FN_CLOSE_COMPLETION).
[in, optional] RequestContext
Valor de contexto para que el proveedor NDK vuelva a pasar 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 |
|---|---|
|
El objeto NDK está cerrado. El proveedor no llamará a la función NdkCloseCompletion. |
|
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. |
|
Error. |
Observaciones
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 se devuelvan todas las devoluciones de llamada en curso y que 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 | 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 |