NdisIMInitializeDeviceInstance

NDIS_STATUS

  NdisIMInitializeDeviceInstance(

    IN NDIS_HANDLE  DriverHandle,

    IN PNDIS_STRING  DeviceInstance

    );

NdisIMInitializeDeviceInstance함수는 인터미디엇 드라이버가 바인딩된 닉드라이버에 I/O연산을 위한 드라이버의 가상 닉을 설정하기위해 NDIS인터미디엇 드라이버의 MiniportInitialize함수를 호출한다.

매개변수

DriverHandle
NdisIMRegisterLayeredMiniport함수에의해 리터된 핸들을 지정한다.

DeviceInstance
버퍼화되고 호출자가 초기화한 셀수있는 스트링의 포인터, 시스템-기본 문자 설정, 드라이버가 가상 닉에대한 정보를 저장하는곳의 레지스트 키를 이름화하는것, 가능하면, 바인딩 지정 정보, 윈도우 2000드라이버에서 이 스트링은 유니코드 문자들을 포함한다.

리턴값s

NdisIMInitializeDeviceInstanceEx함수는 다음중 하나를 리턴할수 있다.:

NDIS_STATUS_SUCCESS
인터미디엇 드라이버의 가상 닉이 성공적으로 초기화됐다.

NDIS_STATUS_NOT_ACCEPTED
NdisIMInitializeDeviceInstanceEx 함수는 DriverHandle에의해 지정된 장치가 이미 초기화됐기때문에 실패한다.

주석

NDIS인터미디엇 드라이버는 일반적으로 ProtocolBindAdapter함수로부터 disIMInitializeDeviceInstance혹은 NdisIMInitializeDeviceInstanceEx함수를 호출한다.

드라이버의 초기화 스크립트는 구성 레지스트리 트리내의 DeviceInstance에의해 설계된 키를 생성했다.

NdisIMInitializeDeviceInstance함수를 호출하기전에 ProtocolBindAdapter함수는 NdisOpenAdapter함수의 성공적인 호출을 하고, 그래서 하위 닉 드라이버와 인터미디엇 드라이버가 바인딩한다. 그리고난후 NdisIMInitializeDeviceInstance함수의 순차적인 호출은 드라이버의 MiniportInitialize함수로 하여금 네트웍I/O연산들을 수행하거고 드라이버의 가상 닉을 초기화 하는데 필요한 어떤 리소슫르을 할당하도록 허용한다. 상위 레벨 프로토콜 드라이버들은 NDIS인터미디엇 드라이버의 초기화가 완료될때 그들 스스로 바인딩할수 있다.

NdisIMInitializeDeviceInstance함수의 호출자는 IRQL PASSIVE_LEVEL에서 동작한다.