структура NDIS_MINIPORT_PAUSE_PARAMETERS (ndis.h)

Статья
02/07/2025

Структура NDIS_MINIPORT_PAUSE_PARAMETERS определяет параметры приостановки для мини-адаптеров.

Синтаксис

typedef struct _NDIS_MINIPORT_PAUSE_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              PauseReason;
} NDIS_MINIPORT_PAUSE_PARAMETERS, *PNDIS_MINIPORT_PAUSE_PARAMETERS;

Члены

Header

Структура NDIS_OBJECT_HEADER для структуры NDIS_MINIPORT_PAUSE_PARAMETERS. NDIS задает элемент типа структуры, заголовка указывает NDIS_OBJECT_TYPE_DEFAULT, элемент редакции NDIS_MINIPORT_PAUSE_PARAMETERS_REVISION_1 и элемент размера NDIS_SIZEOF_MINIPORT_PAUSE_PARAMETERS_REVISION_1.

Flags

Скрытный.

PauseReason

Значение этого элемента зависит от версии NDIS, целевой драйвер мини-порта.

Версия минипорта драйвера NDIS	Ценность
Раньше, чем NDIS 6.40	Непредсказуемые значения. Минипортные драйверы не должны полагаться на значение этого элемента.
6.40 и более поздних версий	NDIS_PAUSE_MINIPORT_DEVICE_REMOVE в определенных условиях, в противном случае NDIS_PAUSE_NDIS_INTERNAL.

Для драйверов минипорта NDIS 6.40 и более поздних версий, работающих в Windows 10 версии 1903 и более поздних версий, значение этого элемента может быть NDIS_PAUSE_MINIPORT_DEVICE_REMOVE, если NDIS гарантирует, что экземпляр адаптера минипорта никогда не получит MiniportRestart вызов снова. В противном случае это значение NDIS_PAUSE_NDIS_INTERNAL. Если установлен флаг NDIS_PAUSE_MINIPORT_DEVICE_REMOVE, драйверы минипорта могут при необходимости выполнять агрессивные оптимизации производительности в обработчике MiniportPause, предполагая, что путь к данным адаптера никогда не будет перезапущен. Драйверы NDIS 6.40 и более поздних версий никогда не будут видеть NDIS_PAUSE_MINIPORT_DEVICE_REMOVE в версиях Windows до Windows 10 версии 1903.

Замечания

Чтобы определить параметры приостановки мини-адаптера, NDIS передает указатель на структуру NDIS_MINIPORT_PAUSE_PARAMETERS в функцию MiniportPause.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в NDIS 6.0 и более поздних версиях.
заголовка	ndis.h (include Ndis.h)

См. также

MiniportPause

NDIS_OBJECT_HEADER

Поделиться через