NdisImmediateReadSharedMemory

VOID NdisImmediateReadSharedMemory( IN NDIS_HANDLE WrapperConfigurationContext, IN ULONG SharedMemoryAddress, IN OUT PUCHAR Buffer, IN ULONG Length );

NdisImmediateReadSharedMemory함수는 공유된 장치 RAM으로부터 지정한 바이트를 읽는다.

매개변수

WrapperConfigurationContext

MiniportInitialize함수에게 전해진 핸들을 지정한다.

SharedMemoryAddress

공유된 장치 메모리 범위의 버스 관련 베이스 주소를 지정한다.

Buffer

이 함수는 SharedMemoryAddress에 시작하는 장치 메모리 범위로부터 읽혀진 데이타를 리턴하는 호출자 할당 버퍼의 포인터

Length

Buffer에 버퍼의 바이트 사이즈를 지정한다. 그러므로 얼마나 데이타를 받았는지를 지정한다.

주석

NdisImmediateReadSharedMemory함수는 호스트가 ,버스관련 베이스 어드레스를 멥하는, 어떻게 공유장치 메모리에 접근하는지를 결정하여, 장치 메모리 영역으로부터 주어진 버퍼로 Length바이트를 복사한다.

미니포트 드라이버는 그 드라이버가 버스 관련 장치메모리 범위에대한 멥된 가상 주소를 얻기위해 아직 NdisMMapIoSpace함수를 호출하지 않았을때 장치 메모리 범위로 부터 데이타를 읽기위한 초기화 동안에 NdisImmediateReadSharedMemory함수를 호출할수 있다.

미니포트는 PnP환경에서 NdisImmediateReadSharedMemory함수를 호출 하지 않아야 한다. 미래 버전에서는 NdisImmediateReadSharedMemory함수를 지원하지 않을지 모른다.

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