Функция 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
Указатель на указанную вызывающим переменную, в которой эта функция возвращает дескриптор в раздел реестра для именованного драйвера минипорта, к которому вызывающий объект привязывается позже. Записи значений в этом ключе содержат сведения, установленные протоколом, зависящие от адаптера.
[in] ProtocolSection
Указатель на указанный вызывающим NDIS_STRING тип, содержащий подсчитываемую строку, указанную в наборе символов по умолчанию системы. Это число именует драйвер сетевой карты NDIS, фактически адаптер, для которого должен быть открыт раздел параметров каждого адаптера в разделе протокола реестра. Для протоколов Windows 2000 и более поздних версий эта подсчитываемая строка содержит символы Юникода. То есть для Windows 2000 и более поздних версий NDIS определяет тип NDIS_STRING как тип UNICODE_STRING.
Этот указатель — это входной параметр SystemSpecific1 для функции ProtocolBindAdapt er вызывающего объекта.
Возвращаемое значение
Никакой
Замечания
NdisOpenProtocolConfiguration возвращает дескриптор, который вызывающий объект может передать впоследствии в Ndis.. функции конфигурации для получения или хранения сведений в реестре.
Драйвер протокола вызывает NdisOpenProtocolConfiguration, чтобы получить дескриптор раздела реестра для последующего передачи другим Ndis.. Функции конфигурации, такие как NdisRead/WriteConfiguration или NdisOpenConfigurationKeyName/Index, если его файл установки хранится в разделе протокола реестра, из которого протокол настраивает свои привязки.
Протокол может вызывать NdisOpenConfigurationKeyByName или NdisOpenConfigurationKeyIndex, чтобы открыть любой подраздел раздела реестра, для которого NdisOpenProtocolConfiguration возвращает дескриптор.
Протоколы Windows 2000 и более поздних версий вызывают подпрограммы поддержки режима ядра, чтобы открыть собственные разделы реестра, относящиеся к протоколу. Дополнительные сведения об этих подпрограммах поддержки см. в сводке по подпрограммам поддержки Kernel-Mode и подпрограммам поддержки управления питанием.
- Целевая платформа: универсальная
- Версия: не поддерживается для драйверов NDIS 6.0 в Windows Vista. Вместо этого используйте NdisOpenConfigurationEx. Поддерживается для драйверов NDIS 5.1 в Windows Vista и Windows XP.
Требования
| Требование | Ценность |
|---|---|
| заголовка | ndis.h (include Ndis.h) |
| библиотеки | Ndis.lib |
| IRQL | PASSIVE_LEVEL |