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

  • Статья

Структура NDIS_GENERIC_OBJECT определяет универсальный объект, который программный компонент может использовать для получения дескриптора NDIS.

Синтаксис

typedef struct _NDIS_GENERIC_OBJECT {
  NDIS_OBJECT_HEADER Header;
  PVOID              Caller;
  PVOID              CallersCaller;
  PDRIVER_OBJECT     DriverObject;
} NDIS_GENERIC_OBJECT, *PNDIS_GENERIC_OBJECT;

Члены

Header

Структура NDIS_OBJECT_HEADER для универсальной объектной структуры (NDIS_GENERIC_OBJECT). NDIS задает для элемента Type структуры, указанной в заголовке , значение NDIS_OBJECT_TYPE_GENERIC_OBJECT, для элемента Revision — значение NDIS_GENERIC_OBJECT_REVISION_1, а для элемента Size — значение sizeof(NDIS_GENERIC_OBJECT).

Caller

Зарезервировано для NDIS.

CallersCaller

Зарезервировано для NDIS.

DriverObject

Объект драйвера, связанный с универсальным объектом. Если объект драйвера отсутствует, этот элемент имеет значение NULL. Это значение передается в параметре DriverObject объекта Функция NdisAllocateGenericObject .

Комментарии

Программные компоненты, которые еще не имеют дескриптора NDIS, вызывают NdisAllocateGenericObject для создания универсального объекта. Такие компоненты используют дескриптор, полученный из NdisAllocateGenericObject , для выделения ресурсов NDIS.

Параметр Sizeобъекта NdisAllocateGenericObject указывает объем памяти в байтах, который необходимо зарезервировать для вызывающего объекта. NdisAllocateGenericObject добавляет дополнительную память после элементов NDIS_OBJECT_STRUCTURE.

Большинству драйверов NDIS не требуется универсальный объект для получения дескриптора. Драйверы протокола NDIS, промежуточного уровня и минипорта получают дескриптор во время инициализации.

Используйте функцию NdisFreeGenericObject , чтобы освободить универсальный объект, созданный с помощью NdisAllocateGenericObject.

Требования

Требование Значение
Минимальная версия клиента Поддерживается в NDIS 6.0 и более поздних версиях.
Верхняя часть ndis.h (включая Ndis.h)

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

NDIS_OBJECT_HEADER

NdisAllocateGenericObject

NdisFreeGenericObject