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

  • Статья

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

NdisOpenProtocolConfiguration возвращает дескриптор для раздела реестра, в котором хранятся сведения об адаптере драйвера протокола.

Синтаксис

void NdisOpenProtocolConfiguration(
  [out] PNDIS_STATUS  Status,
  [out] PNDIS_HANDLE  ConfigurationHandle,
  [in]  PCNDIS_STRING ProtocolSection
);

Параметры

[out] Status

Указатель на переменную, предоставленную вызывающей стороной, которая имеет значение NDIS_STATUS_SUCCESS или состояние сбоя при возврате из этой функции.

[out] ConfigurationHandle

Указатель на переменную, предоставленную вызывающей стороны, в которой эта функция возвращает дескриптор в раздел реестра для именованного драйвера miniport, к которому вызывающий объект будет привязан позже. Записи значений в этом ключе содержат сведения об установленном протоколе адаптере.

[in] ProtocolSection

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

Этот указатель является входным параметром SystemSpecific1 на функцию ProtocolBindAdapter вызывающего объекта.

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

None

Remarks

NdisOpenProtocolConfiguration возвращает дескриптор, который вызывающий объект может впоследствии передать в Ndis.. Функции конфигурации для извлечения или хранения сведений в реестре.

Драйвер протокола вызывает NdisOpenProtocolConfiguration , чтобы получить дескриптор раздела реестра для последующей передачи другим Ndis.. Функции конфигурации , такие как NdisRead/WriteConfiguration или NdisOpenConfigurationKeyByName/Index, если файл установки хранит сведения о конфигурации адаптера в разделе протокола реестра, из которого протокол настраивает свои привязки.

Протокол может вызывать NdisOpenConfigurationKeyByName или NdisOpenConfigurationKeyByIndex , чтобы открыть любой подраздел раздела реестра, для которого NdisOpenProtocolConfiguration возвращает дескриптор.

Протоколы Windows 2000 и более поздних версий вызывают подпрограммы поддержки режима ядра для открытия собственных разделов реестра, относящихся к протоколу. Дополнительные сведения об этих подпрограммах поддержки см. в сводке по подпрограммам поддержки Kernel-Mode и подпрограммам поддержки управления питанием.

  • Целевая платформа: универсальная
  • Версия: не поддерживается для драйверов NDIS 6.0 в Windows Vista. Вместо этого используйте NdisOpenConfigurationEx. Поддерживается для драйверов NDIS 5.1 в Windows Vista и Windows XP.

Требования

Требование Значение
Заголовок ndis.h (включая Ndis.h)
Библиотека Ndis.lib
IRQL PASSIVE_LEVEL

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