NdisReadConfiguration
VOID
NdisReadConfiguration(
OUT PNDIS_STATUS Status,
OUT PNDIS_CONFIGURATION_PARAMETER *ParameterValue,
IN NDIS_HANDLE ConfigurationHandle,
IN PNDIS_STRING Keyword,
IN NDIS_PARAMETER_TYPE ParameterType
);
|
NdisReadConfiguration은 열린 레지스트리 키에 대한 핸들이 주어진다면은 레지스트리로부터 특정 타입의 이름을 가진 엔트리에 대한 값을 리턴한다.
매개변수
- Status
- 이 함수가 다음과 같은 하나의 값으로 호출에 대한 상태를 리턴하는 호출자 제공 변수를 가리킨다.
- NDIS_STATUS_SUCCESS
- ParameterValue에 지정된 버퍼는 리턴된 구성 정보를 포함한다.
- NDIS_STATUS_RESOURCES
- NDIS는 요구된 정보를 리턴하기 위한 충분한 메모리로 자원을 할당할 수 없다.
- NDIS_STATUS_FAILURE
- 요구된 정보는 ConfigurationHandle에 의해 지칭된(designated) 열린 레지스트리 키 아래에 발견될 수 없다.
- ParameterValue
- NdisReadConfiguration에 대한 성공적인 호출이 아래 정의된 NDIS_CONFIGURATION_PARAMETER에 대한 포인터를 리턴하는 호출자 제공 변수를 가리킨다.
typedef struct _NDIS_CONFIGURATION_PARAMETER
{
NDIS_PARAMETER_TYPE ParameterType;
union
{
ULONG IntegerData;
NDIS_STRING StringData;
} ParameterData;
} NDIS_CONFIGURATION_PARAMETER, *PNDIS_CONFIGURATION_PARAMETER;
이 구조체의 멤버는 다음의 데이터를 포함한다.
- ParameterType
- 만약 호출이 성공적이라면은 ParameterType에 값이 일치한다.
- ParameterData
- 주어진 이름의 엔트리 값을 지정한다. 만약 ParameterType이 문자열 타입이면은 이 멤버는 시스템 디폴트 문자 셋인 버퍼화되고, 카운트화된 문자열 포인터이다. 윈도우즈 NT에서 그러한 문자열은 유니코드 문자들을 포함한다.
- ConfigurationHandle
- NIC 드라이버의 ..\DriverName\Parameters 레지스트리 키인 NdisOpenConfiguration에 의해 리턴된 핸들을 지정하거나 레지스트리의 프로토콜 섹션 부분에 프로토콜의 ..\NICDriverInstance\Parameters\ProtocolName 키인 NdisOpenProtocolConfiguration에 의해 리턴된 핸들을 지정한다.
- keyword
- 값을 리턴하기 위해 열린 레지스트리 키 아래에 엔트리의 이름을 지정하는 시스템 디폴트 문자셋인 호출자 제공 카운트된 문자열을 가리킨다.
이 매개변수는 또한 모든 NDIS 드라이버들을 위해 다음에 미리 정의된 글로벌 키워드중에 하나를 가리킬 수 있다.
| 미리 정의된 키워드 |
미리 정의된 리턴값 |
| Environment |
NdisEnvironmentWindowsNt
NdisEnvironmentWindows |
| ProcessorType |
NdisProcessorX86
//
// Following possible only if
// current machine's Environment ==
// NdisEnvironmentWindowsNt
//
NdisProcessorAlpha
// Following possible only if legacy driver
NdisProcessorMips
NdisProcessorPpc |
| NdisVersion |
0xMMMMmmmm
// where MMMM is the major version and
// mmmm the minor version number.
// For example, 0x00050000 indicates the
// the driver is connection-oriented
// (current version of NDIS library), while
// 0x00040000 indicates the driver
// uses underlying connectionless media. |
- ParameterType
- 다음중 하나로서 값 엔트리 타입을 지정한다.
- NdisParameterInteger
- 십진 표기로 정수를 지정한다.
- NdisParameterHexInteger
- 16진 표시로 정수를 지정한다.
- NdisParameterString
- 타입 NDIS_STRING의 문자열을 지정한다. 윈도우즈 NT 드라이버를 위해, 이 값은 숫자화된 유니코드 문자열이다.
- NdisParameterMultiString
- 윈도우즈 NT 정의된 REG_MULTI_SZ 타입의 멀티 문자열 매개변수를 지정한다.
주석
윈도우즈 NT 구성 레지스트리에서 NDIS 키워드는 값 엔트리 이름과 비슷하다. 그러한 이름은 0으로 끝나는 숫자화된 연속적인 유니코드 문자들이다.
모든 NDIS 드라이버는 설치 스크립트를 사용하여 드라이버의 Parameters 키 아래에 레지스트리내에 구성 정보를 설정할 수 있다. 예를 들어, 프로토콜 드라이버는 NdisRegisterProtocol 호출에 전달될 수 있는 미리 포맷화된 문자열 값을 엔트리로서 자신의 이름을 저장할 수 있다.
각 NIC 드라이버는 또한 드라이버의 Parameters 레지스트리 키 아래에 값 엔트리들이 관련되어 있다. 어떤 특정 NIC 드라이버를 위해 값 엔트리들은 원래 장치 종속이 될 수 있다. 예를 들어, 이더넷 NIC 드라이버는 InterruptNumber, SharedMemoryAddress, MulticastListSize 와 같은 키워드들을 가질 것이다. 그러한 NDIS 키워드 같은 관련된 값은 정수(ULONG-타입) 혹은 문자열 (NDIS_STRING - 타입)이 될 수 있다. 예를 들어, 이미 언급된 InterruptNumber 엔트리를 위한 가능한 값들은 NdisParameterInter 값들 2, 3, 4, 5 혹은 NdisParameterHexInteger 값으로 16진수로 같은 값이 될 수 있다.
NdisReadConfiguration Keyword에 호출자 제공 문자열을 버퍼화하고 카피하고 호출자에게 제어를 리턴하기 전에 이 복사를 위해 할당된 저장공간을 해제한다. NDIS_CONFIGURATION_PARAMETER 구조체를 위해 할당된 메모리는 드라이버가 NdisCloseConfiguration에 ConfigurationHandle을 해제할 때 해제되어진다. NdisReadConfiguration의 호출자는 Keyword에 버퍼화된 문자열을 해제할 책임이 있다.
셋업과 설치 스크립트에 관한 더 자세한 정보는, Programmer's Guide를 봐라.
NdisReadConfiguration에 대한 호출자는 IRQL PASSIVE_LEVEL에서 실행한다.
|