Макрос NdisMInitializeWrapper (ndis.h)

Статья
02/26/2024

Примечание NDIS 5. X является нерекомендуемым и заменен NDIS 6. x. Сведения о разработке новых драйверов NDIS см. в статье Сетевые драйверы, начиная с Windows Vista. Сведения о переносе NDIS 5. x драйверы для NDIS 6. x, см. раздел Перенос драйверов NDIS 5.x в NDIS 6.0.

NdisMInitializeWrapper уведомляет NDIS о инициализации нового драйвера минипорта.

Синтаксис

VOID NdisInitializeWrapper(
  _Out_ PNDIS_HANDLE  NdisWrapperHandle,
  _In_ PVOID SystemSpecific1,
  _In_ PVOID SystemSpecific2,
  _In_ PVOID SystemSpecific3
);

Параметры

[out] _a

Указатель на переменную, предоставленную вызывающим абонентом, в которой NDIS возвращает дескриптор, представляющий себя. Если вызов NdisMInitializeWrapper завершается сбоем, NDIS устанавливает для переменной в NdisWrapperHandle значение NULL.

[in] _b

Указывает указатель системного типа.

Для драйверов Windows 2000 и более поздних версий это указатель на непрозрачные входные данные объекта драйвера для функции DriverEntry драйвера мини-порта.

[in] _c

Указывает указатель системного типа.

Для драйверов Windows 2000 и более поздних версий это указатель на непрозрачный входной путь реестра для функции DriverEntry драйвера мини-порта.

[in] _d

Указывает указатель системного типа.

Для драйверов Windows 2000 и более поздних версий этот указатель должен иметь значение NULL , когда драйвер мини-порта вызывает NdisMInitializeWrapper.

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

None

Remarks

Драйвер сетевой карты или промежуточный драйвер должен вызвать NdisMInitializeWrapper , прежде чем вызывать любую другую функцию NdisXxx. Обычно этот вызов является начальным действием любой функции DriverEntry драйвера сетевой карты, которая вызывает NdisMRegisterMiniport или NdisIMRegisterLayeredMiniport с возвращенным NdisWrapperHandle next. Промежуточные драйверы NDIS также должны вызывать NdisMInitializeWrapper из функции DriverEntry , а затем вызывать NdisMRegisterMiniport или NdisIMRegisterLayeredMiniport с возвращенным NdisWrapperHandle.

Последующие вызовы такого драйвера к функциям инициализации и конфигурации NdisXxx должны передавать NdisWrapperHandle в качестве параметра. Следовательно, это входной параметр для функции MiniportInitialize .

Если вызов NdisMInitializeWrapper завершается сбоем, NDIS устанавливает для переменной в NdisWrapperHandleзначение NULL. Драйвер всегда должен проверка значение этой переменной после возврата NdisMInitializeWrapper. Если значение равно NULL, драйвер должен завершить вызов функции DriverEntry .