NdisOpenConfiguration
VOID
NdisOpenConfiguration(
OUT PNDIS_STATUS Status,
OUT PNDIS_HANDLE ConfigurationHandle,
IN NDIS_HANDLE WrapperConfigurationContext
);
|
NdisOpenConfiguration는 NDIS NIC 드라이버의 ..\DriverName\Parameters 레지스트리 키를 위한 핸들을 리턴한다.
매개변수
- Status
- 이 함수가 레지스트리 키를 열기 위한 시도의 상태를 리턴하는 호출자 제공 변수를 가리킨다.
- NDIS_STATUS_SUCCESS
- ConfigurationHandle에 값이 유효하다.
- NDIS_STATUS_FAILURE
- 키가 열려 있지 않다.
- ConfigurationHandle
- 이 함수가 레지스트리 HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\DriverName\Parameters 키에 대한 핸들을 리턴하는 호출자 제공 변수를 가리킨다.
- WrapperConfigurationContext
- MiniportInitialize을 위한 핸들 입력을 지정한다.
주석
NdisOpenConfiguration에 의해 리턴된 핸들을 가지고, NDIS 미니포트는 레지스트리로부터 NIC에 대한 구성 정보를 뽑기 위해(extract) 하나나 그 이상으로 NdisReadConfiguration을 호출할 수 있다. 미니포트는 또한 NIC이 현 컴퓨터에 인스톨될 때 레지스트리에 저장된 소프트웨어 구성 네크워크 주소 정보를 검색하기 위해 이 핸들을 가진 NdisReadConfiguration을 호출할 수 있다.
최소, 미니포트의 인스톨 스크립트는 레지스트리내에 다음의 구성 정보를 저장해야 한다.
- NIC의 I/O 버스 인터페이스 타입
- 만약 ISA 버스가 아니면은 버스 넘버
- I/O 버스 인터페이스 타입에 의존하는 NIC의 어댑터 ID 값은 다음과 같은 버스-타입 특정 구성 데이터 값들의 하나와 동등하다.
- 만약 NIC이 EISA 버스이면은 EISA 값은 CompressedId
- 만약 NIC이 MCA 버스이면은 POS의 값은 AdapterId
- 만약 NIC이 PCI 버스이면은 PCI 값은 DeviceId
윈도우즈 NT 드라이버들의 설치에 대해 더 자세한 정보는 Programmer's Guide를 봐라.
ISA 버스들인 NIC 드라이버들은 항상 NdisReadConfiguration 함수로 레지스트리로부터 NIC을 위한 버스 관련 구성 매개변수들을 얻는다. 다른 타입의 I/O 버스들인 NIC 드라이버들은 또한 NdisMRegisterInterrupt, NdisMMapIoSpace, NdisMRegisterIoPortRange와 같은 함수들을 호출하는데 적당한 버스 관련 NIC 특정 구성 매개변수들을 얻기 위해 NdisReadEisaSlotInformation함수와 같은 NdisXxx 버스 타입 특정 구성 함수들을 호출할 수 있다.
NIC 드라이버는 그러한 드라이버가 어떤 버스 타입 특정 구성 함수들을 호출하기 전에 NIC이 발견되어지는 I/O 버스 타입을 알기 위해 NdisMSetAttributes 혹은 NdisMSetAttributesEx를 호출해야 한다.
드라이버는 레지스트리 구성 정보를 consume하고 수정되어진 후, 드라이버는 NdisOpenConfiguration으로부터 얻어진 핸들을 해제하기 위해 NDIS가 NdisReadConfiguration, NdisReadNetworkAddress, NdisWriteConfiguration에 대한 드라이버의 호출에서 할당된 일시 저장 장소를 해제하기 위해 NdisCloseConfiguration을 호출해야 한다.
NdisOpenConfiguration의 호출자는 IRQL PASSIVE_LEVEL에서 실행한다.
|