NdisIMInitializeDeviceInstanceEx

NDIS_STATUS NdisIMInitializeDeviceInstanceEx( IN NDIS_HANDLE DriverHandle, IN PNDIS_STRING DriverInstance, IN NDIS_HANDLE DeviceContext OPTIONAL );

NdisIMInitializeDeviceInstanceEx 함수는 드라이버의 가상 NIC을 초기화하기 위해 그리고 선택적으로 연속적인 바인드된 프로토콜들을 위한 드라이버의 가상 NIC에 대한 상태 정보를 설정하기 위해 NDIS 인터미디엇 드라이버의 MiniportInitialize 함수를 호출한다.

매개변수

DriverHandle

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

DriverInstance

드라이버가 가상 NIC에 대한 정보와 바인딩 특정 정보를 저장하는 레지스트리 키 이름을 가진 시스템 디폴트 문자 집합으로 버퍼화된 호출자 초기화된 counted 문자열을 가리키낟. 윈도우즈 2000 에서는, 이 값은 counted Unicode 문자열이다.

인터미디엇 드라이버의 설치 스크립트는 HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services 레지스트리 트리내에 DeviceInstance 값에 의해 할당된 키를 만든다.

DeviceContext

이러한 가상 NIC에 바인드된 상위 레벨 프로토콜들이 사용할 수 있는 가상 NIC에 대한 드라이버 정의 장치 컨텍스트 정보를 설정하는 호출자 제공 메모리를 가리킨다. 이 매개변수는 만약 인터미디엇 드라이버가 그러한 장치 컨텍스트 영역을 가지고 있지 않다면은 NULL이다.

리턴값

NdisIMInitializeDeviceInstanceEx 함수는 다음과 같은 값을 리턴할 수 있다.

NDIS_STATUS_SUCCESS

인터미디엇 드라이버의 가상 NIC은 성공적으로 초기화되었다.

NDIS_STATUS_NOT_ACCEPTED

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

주석

NDIS 인터미디엇 드라이버는 NDIS가 드라이버의 가상 NIC을 설정하기 위해 드라이버의 MiniportInitialize 함수를 호출할 때 제어하는 ProtocolBindAdapter 함수로부터 NdisIMInitializeDeviceInstanceEx 함수를 호출해야 한다. NDIS 인터미디엇 드라이버로부터 NdisIMInitializeDeviceInstanceEx 함수 혹은 NdisIMInitializeDeviceInstance 함수를 호출하는 것에 대한 실패는 그러한 드라이버가 성공적으로 로딩하는 것을 막는다. 그러한 드라이버는 만약 MiniportInitialize 함수가 실행하지 않는다면은 상위 레벨 프로토콜들을 위해 가상 NIC이 연산을 할 수 없다.

NdisIMInitializeDeviceInstanceEx 함수를 호출하기 전에, 인터미디엇 드라이버가 프로토콜로서 아래 NIC 미니포트에 바인딩하기 위해 인터미디엇 드라이버의 ProtocolBindAdapter 함수는 NdisOpenAdapter 함수에 대한 성공적인 호출을 해야 한다. ProtocolBindAdapter 함수는 ProtocolBindAdapter 함수에 의해 모아진 아래 NIC의 능력들에 대한 인터미디엇 드라이버 결정 정보를 설정하면서 DeviceContext 영역을 할당할 수 있다. 인터미디엇 드라이버의 MiniportInitialize 함수는 드라이버의 가상 NIC에 대한 정보로 이러한 컨텍스트 영역을 설정하기 위해 그러한 정보를 사용할 것이다.

NdisOpenAdapter 함수에 대한 성공적인 호출 후에, NdisIMInitializeDeviceInstanceEx 함수에 대한 인터미디엇 드라이버의 연속적인 호출은 NDIS에게 인터미디엇 드라이버의 MiniportInitialize 함수를 호출하도록 한다. MiniportInitialize 함수는 NdisMSetAttributesEx 함수를 호출하는 것과 같은 네트워크 I/O 연산들을 실행하는 데 필요하고 연산 상태에 대한 드라이버의 가상 NIC 을 초기화하는 데 필요한 어떤 자원들을 할당한다. 그리고 나서 아직 상위 레벨 드라이버는 인터미디엇 드라이버의 초기화가 성공적으로 완성될 때 가상 NIC과 바인드할 수 있다. 인터미디엇 드라이버의 MiniportInitialize 함수는 만약 그러한 영역이 ProtocolBindAdapter 함수에 의해 제공된다면은 DeviceContext 영역에 대한 접근을 얻기 위해 NdisIMGetDeviceContext 함수를 호출할 수 있다.

MiniportInitialize 함수에 대한 제어를 리턴한 후에, 인터미디엇 드라이버의 장치 컨텍스트 영역은 그러한 컨텍스트 영역에서 정보를 접근하기 위해 같은 가상 NIC에 대한 바인드된 모든 상위 레벨 프로토콜들을 허락하는 인터미디엇 드라이버 정의 데이터를 포함할 수 있다. 그러한 상위 레벨 프로토콜은 NdisIMGetBindingContext 함수에 대한 인터미디엇 드라이버 제공 장치 컨텍스트를 쿼리할 수 있다.

NdisIMInitializeDeviceInstanceEx 함수는 IRQL < DISPATCH_LEVEL 에서 실행한다.