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

Consulte también

MiniportInitializeEx

NdisMRegisterMiniportDriver

UNICODE_STRING