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

The NdisReadConfiguration function returns the value of a named entry of the specified type from the registry, given the handle to an open registry key. This function must be invoked serially with respect to itself and the NdisWriteConfiguration function.

Syntax

VOID NdisReadConfiguration(
  [out] PNDIS_STATUS                  Status,
  [out] PNDIS_CONFIGURATION_PARAMETER *ParameterValue,
  [in]  NDIS_HANDLE                   ConfigurationHandle,
  [in]  PNDIS_STRING                  Keyword,
  [in]  NDIS_PARAMETER_TYPE           ParameterType
);

Parameters

[out] Status

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

Value	Meaning
NDIS_STATUS_SUCCESS	The buffer at ParameterValue contains the returned configuration information.
NDIS_STATUS_RESOURCES	NDIS не удалось выделить ресурсы, как правило, достаточно памяти, чтобы вернуть запрошенные сведения.
NDIS_STATUS_FAILURE	The requested information could not be found under the opened registry key designated by the ConfigurationHandle.

[out] ParameterValue

Указатель на расположение памяти, в котором NDIS предоставляет указатель на объект NDIS_CONFIGURATION_PARAMETER structure if the call to NdisReadConfiguration is successful. NDIS выделяет память для NDIS_CONFIGURATION_PARAMETER structure.

[in] ConfigurationHandle

The handle to a registry key that was returned by the NdisOpenConfigurationEx, NdisOpenConfigurationKeyByIndex, or NdisOpenConfigurationKeyByName function.

[in] Keyword

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

Кроме того, указатель на указанный вызывающим NDIS_STRING_CONSTANT укажите одно из следующих предопределенных имен записей вместе с предопределенными значениями возвращаемых значений:

Предопределенное имя записи	Предопределенные возвращаемые значения
ProcessorType	NdisProcessorX86 NdisProcessorAmd64 NdisProcessorIA64 NdisProcessorAlpha Следующие возможности возможны только в том случае, если старый драйвер (предварительная версия NDIS 6.0): NdisProcessorMips NdisProcessorPpc
NdisVersion	0xMMMMmmmm, where MMMM is the major version and mmmm is the minor version number. Например, 0x00050000 указывает, что самая высокая версия NDIS, поддерживаемая системой, является основной версией 5, дополнительными версиями 0.

Предопределенное имя записи

Предопределенные возвращаемые значения

ProcessorType

NdisProcessorX86
NdisProcessorAmd64
NdisProcessorIA64
NdisProcessorAlpha

Следующие возможности возможны только в том случае, если старый драйвер (предварительная версия NDIS 6.0):

NdisProcessorMips
NdisProcessorPpc

NdisVersion

0xMMMMmmmm, where MMMM is the major version and mmmm is the minor version number. Например, 0x00050000 указывает, что самая высокая версия NDIS, поддерживаемая системой, является основной версией 5, дополнительными версиями 0.

[in] ParameterType

The type of the value entry that is specified as one of the NDIS_PARAMETER_TYPE enumeration values. Этот параметр игнорируется в Windows NT и более поздних версиях.

Return value

None

Remarks

In the configuration registry of Windows 2000 and later versions, an NDIS keyword is a synonym for a value entry name. Such a name is a counted sequence of Unicode characters, terminated with a NULL.

Every NDIS driver can set up configuration information in the registry for itself using the AddReg directive in its INF file. Например, драйвер протокола может хранить собственное имя в качестве записи с предварительно сформированным строковым значением, которое можно передать в вызовы NdisRegisterProtocolDriver function. Дополнительные сведения см. в разделах add-registry-sections in a Network INF File.

Каждый минипорт-драйвер также имеет связанные записи значений в реестре. Записи значений для любого конкретного драйвера минипорта могут быть зависимыми от устройства в природе. Например, драйвер мини-порта может иметь ключевые слова, такие как *FlowControl, *SpeedDuplex и *InterruptModeration. Значение, связанное с таким ключевым словом NDIS, может быть целым числом (типом ULONG) или строкой (NDIS_STRING типа). For example, the set of possible values for the already mentioned *FlowControl entry might be NdisParameterInteger values 0, 1, 2, or 3, or the equivalents in hexadecimal as NdisParameterHexInteger values.

NdisReadConfiguration buffers and copies the caller-supplied string at Keyword and releases the storage it allocates for this copy before it returns control to the caller. Память, выделенная для NDIS_CONFIGURATION_PARAMETER structure is freed when the driver releases the ConfigurationHandle with the NdisCloseConfiguration function. The caller of NdisReadConfiguration is responsible for releasing the buffered string at Keyword.

Обратите внимание, что NDIS не проверяет значения, которые драйвер считывает из реестра. The caller of NdisReadConfiguration must therefore not make any assumptions about such values and must validate each value read from the registry. Если вызывающий объект определяет, что значение выходит за пределы, вместо него следует использовать значение по умолчанию.

Дополнительные сведения о файлах установки и установки см. в обзоре установки устройств.

Requirements

Requirement	Value
минимальные поддерживаемые клиентские	Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. NdisReadConfiguration (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. NdisReadConfiguration (NDIS 5.1)) в Windows XP.
Target Platform	Universal
Header	ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	PASSIVE_LEVEL
правил соответствия DDI	Irql_Miscellaneous_Function(ndis)

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-07-23