My yesterday's beautiful. :: NdisIMGetDeviceContext

NdisIMGetDeviceContext allows an NDIS intermediate driver's MiniportInitialize function to access the device context area allocated by its ProtocolBindAdapter function.
NdisIMGetDeviceContext는 NDIS IM driver의 MiniportInitialize 함수가 ProtocolBindAdapter function으로 부터 할당된 디바이스 context area에 접근 할 수 있도록 허락한다.

Version Information

Windows Vista

Obsolete.

NDIS 6.0 drivers: Not supported.
NDIS 5.1 drivers: Supported.

Windows XP

Supported.

NDIS 5.1 drivers: Supported.

NDIS_HANDLE
NdisIMGetDeviceContext(
IN NDIS_HANDLE MiniportAdapterHandle
);

MiniportAdapterHandle: Specifies the handle input to MiniportInitialize.

Return Value

NdisIMGetDeviceContext returns access to the device context area for the virtual NIC identified by MiniportAdapterHandle, or it returns NULL if the driver's ProtocolBindAdapter function did not allocate such a device context area.

Headers

Declared in Ndis.h. Include Ndis.h.

Comments

An NDIS intermediate driver's MiniportInitialize function calls NdisIMGetDeviceContext to access the device context area for the virtual NIC it is initializing. Usually, the memory for such an area is provided by the intermediate driver's ProtocolBindAdapter function, which calls NdisIMInitializeDeviceInstanceEx with a pointer to this area, thereby causing the driver's MiniportInitialize function to be called. However, an intermediate driver is not required to have such a context area.
NDIS IM driver의 MiniportInitialize 함수는 가상 NIC가 초기화 되는 것을 위한 device context area에 접근하기 위해 NdisIMGetDeviceContext를 호출한다. 보통, IM driver의 ProtocolBindAdapter함수를 통해 공급된 메모리는, NdisIMInitializeDeviceInstanceEx와 함께 호출 되기 때문에 driver의 MiniportInitialize함수는 호출되어졌던 것이다. 아무튼 IM driver는 context area를 꼭 가질 필요가 없다.

On return from NdisIMGetDeviceContext, MiniportInitialize sets up the driver-defined state for the virtual NIC with whatever information the intermediate driver writer intends to be useful to still higher level protocols that bind themselves subsequently to its virtual NIC.
NdisIMGetDeviceContext의 return, MiniportInitialize는 virtual NIC를 위해 higher level protocols에서 유용해 질 IM driver information와 함께 driver-defined state를 설정하는데 이것은 MiniportInitialize스스로가 MiniportInitialize의 virtual NIC를 순차적으로 감싼다.

Still higher level NDIS protocols bound to the same virtual NIC subsequently can access this device context area by calling NdisIMGetBindingContext from their ProtocolBindAdapter functions.
아직도 higherlevel NDIS protocols가 같은 ProtocolBindAdapter 함수들로 부터 호출되고 있는 NdisIMGetBindingContext virtual NIC가 순차적으로 접근 가능한 이 device context area에게 전달한다.

Callers of NdisIMGetDeviceContext must be running at IRQL <= DISPATCH_LEVEL. Typically, NDIS calls MiniportInitialize functions at IRQL = PASSIVE_LEVEL.