Функция 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, чтобы отменить операцию инициализации. Например, если удаляется базовый драйвер, необходимый промежуточному драйверу для нормальной работы, промежуточный драйвер может отменить инициализацию для любых виртуальных мини-портов, связанных с удаленным драйвером.

Требования

Требование Значение
Минимальная версия клиента Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisIMCancelInitializeDeviceInstance (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisIMCancelInitializeDeviceInstance (NDIS 5.1)) в Windows XP.
Целевая платформа Персональный компьютер
Верхняя часть ndis.h (включая Ndis.h)
Библиотека Ndis.lib
IRQL PASSIVE_LEVEL
Правила соответствия DDI Irql_IM_Function(ndis)

См. также раздел

MiniportInitializeEx

NdisIMInitializeDeviceInstanceEx

NdisMRegisterMiniportDriver

UNICODE_STRING