Функция 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 |