Función NdisIMCancelInitializeDeviceInstance (ndis.h)
La función NdisIMCancelInitializeDeviceInstance cancela una llamada anterior a . Función NdisIMInitializeDeviceInstanceEx .
Sintaxis
NDIS_STATUS NdisIMCancelInitializeDeviceInstance(
[in] NDIS_HANDLE DriverHandle,
[in] PNDIS_STRING DeviceInstance
);
Parámetros
[in] DriverHandle
Controlador de minipuerto que el controlador Función NdisMRegisterMiniportDriver devuelta en el parámetro NdisMiniportDriverHandle .
[in] DeviceInstance
Puntero a un tipo de NDIS_STRING que describe una cadena con recuento inicializado por el autor de la llamada en el juego de caracteres predeterminado del sistema. La cadena contiene el nombre de la clave del Registro en la que el controlador almacena información sobre una miniporte virtual y, posiblemente, información específica del enlace. Para los controladores de Microsoft Windows 2000 y versiones posteriores, esta cadena contiene caracteres Unicode. Es decir, para Windows 2000 y versiones posteriores, NDIS define el tipo de NDIS_STRING como un tipo de UNICODE_STRING .
Valor devuelto
NdisIMCancelInitializeDeviceInstance devuelve NDIS_STATUS_SUCCESS si canceló la llamada anterior a NdisIMInitializeDeviceInstanceEx. De lo contrario, devuelve NDIS_STATUS_FAILURE si no hay ninguna manera de detener la operación de inicialización para la minipuerto virtual.
Comentarios
Un controlador intermedio llama a Función NdisIMInitializeDeviceInstanceEx para iniciar la operación de inicialización de un miniporte virtual. Antes de que NDIS llame a la función MiniportInitializeEx del controlador, el controlador puede llamar a NdisIMCancelInitializeDeviceInstance para cancelar la operación de inicialización. Por ejemplo, si se quita un controlador subyacente que requiere el controlador intermedio para la operación normal, el controlador intermedio puede cancelar la inicialización de cualquier miniporte virtual que esté asociado al controlador quitado.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisIMCancelInitializeDeviceInstance (NDIS 5.1)) en Windows Vista. Compatible con controladores NDIS 5.1 (consulte NdisIMCancelInitializeDeviceInstance (NDIS 5.1)) en Windows XP. |
| Plataforma de destino | Escritorio |
| Encabezado | ndis.h (incluya Ndis.h) |
| Library | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| Reglas de cumplimiento de DDI | Irql_IM_Function(ndis) |