Функция NdisIMCancelInitializeDeviceInstance (ndis.h)

Функция NdisIMCancelInitializeDeviceInstance отменяет предыдущий вызов функция NdisIMInitializeDeviceInstanceEx.

Синтаксис

NDIS_STATUS NdisIMCancelInitializeDeviceInstance(
  [in] NDIS_HANDLE  DriverHandle,
  [in] PNDIS_STRING DeviceInstance
);

Параметры

[in] DriverHandle

Обработчик минипорта, который функция NdisMRegisterMiniportDriver, возвращенная в параметре NdisMiniportDriverHandle.

[in] DeviceInstance

Указатель на тип NDIS_STRING, описывающий инициализированную вызывающую строку в наборе символов по умолчанию системы. Строка содержит имя раздела реестра, в котором драйвер хранит сведения о виртуальном минипорте и, возможно, сведения о привязке. Для драйверов Microsoft Windows 2000 и более поздних версий эта строка содержит символы Юникода. То есть для Windows 2000 и более поздних версий NDIS определяет тип NDIS_STRING как тип UNICODE_STRING.

Возвращаемое значение

NdisIMCancelInitializeDeviceInstance возвращает NDIS_STATUS_SUCCESS, если он отменил предыдущий вызов NdisIMInitializeDeviceInstanceEx. В противном случае возвращается NDIS_STATUS_FAILURE, если нет способа остановить операцию инициализации для виртуального мини-порта.

Замечания

Промежуточный драйвер вызывает функцию NdisIMInitializeDeviceInstanceEx для запуска операции инициализации виртуальных мини-портов. Прежде чем NDIS вызывает функцию miniportInitializeEx, драйвер может вызывать NdisIMCancelInitializeDeviceInstance, чтобы отменить операцию инициализации. Например, если базовый драйвер, требующий промежуточного драйвера для нормальной работы, удаляется, промежуточный драйвер может отменить инициализацию для любых виртуальных мини-портов, связанных с удаленным драйвером.

Требования

См. также

MiniportInitializeEx

NdisMRegisterMiniportDriver

UNICODE_STRING