NdisOpenProtocolConfiguration

VOID NdisOpenProtocolConfiguration( OUT PNDIS_STATUS Status, OUT PNDIS_HANDLE ConfigurationHandle, IN PNDIS_STRING ProtocolSection );

NdisOpenProtocolConfiguration은 HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\NICDriverInstance\Parameters\ProtocolName 레지스트리 키를 위한 핸들을 리턴한다.

매개변수

Status

이 함수로부터의 리턴값에 NDIS_STATUS_SUCCESS 혹은 NDIS_STATUS_FAILURE로 설정되는 호출자 제공 변수를 가리킨다.

ConfigurationHandle

이 함수는 호출자가 나중에 바인드할 이름을 가진 드라이브를 위한 레지스트리 값에 대한 핸들을 리턴하는 호출자 제공 변수를 가리킨다. 이 키 아래의 값 엔트리들은 프로토콜 설치, 어댑터 특정 정보를 포함한다.

ProtocolSection

레지스트리 프로토콜 섹션 내에 Parameters\ProtocolName 키로 열려 있는 NDIS 드라이버 즉 어댑터를 이름짓는, 시스템 디폴트 문자 셋으로 지정되어지는 숫자화된 문자열을 가리킨다. Windows NT 프로토콜들을 위하여 이 숫자화된 문자열은 유니코드 문자들을 포함한다.

ProtocolBindAdapter 함수를 가지는 NDIS 드라이버들을 위하여, 이 포인터는 ProtocolBindAdapter에 SystemSpecific1 입력 매개변수이다.

주석

이 함수는 호출자가 레지스트리내에 있는 정보를 검색하고 혹은 저장하는 Ndis...Configuration 함수들에게 계속해서 전달할 수 있는 핸들을 리턴한다.

프로토콜 드라이버는 만약 프로토콜 드라이버나 그 설치 스크립트가 프로토콜이 바인들을 설정하는 것으로부터 레지스트리의 프로토콜 섹션의 어댑터 특정 구성 정보를 저장한다면은 NdisReadConfiguration 이나 NdisWriteConfiguration에 전달하는 레지스트리 키 핸들을 얻기 위해 NdisOpenProtocolConfiguration을 호출한다.

윈도우즈 NT 프로토콜은 커널 모드 루틴들을 호출해서 그들 자신의 \DriverName\Parameters 레지스트리 키들을 연다. 이러한 지원 루틴들을 위한 더 많은 정보들을 얻기 위해서 Kernel-Mode Driver Reference를 보라.

NdisOpenProtocolConfiguration에 대한 호출자는 IRQL PASSIVE_LEVEL에서 실행한다.