NdisBufferVirtualAddress

PVOID

  NdisBufferVirtualAddress(

    IN PNDIS_BUFFER  Buffer

    );

드라이버들은 NdisBufferVirtualAddress함수 대신에 NdisBufferVirtualAddressSafe함수를 호출한다. NdisBufferVirtualAddress함수와는 다르게 NdisBufferVirtualAddressSafe함수는 만약 시스템 리소스들이 낮거나 다 써버렸는지의 버그 체크를 하지 않는다.

매개변수

Buffer
기본 가상 주소가 리턴되는 버퍼 디스크립터의 포인터.

리턴값

NdisBufferVirtualAddress함수는 주어진 버퍼 디스크립터에의해 설명되어지는 물리페이지를 맵하는 기본적인 시스템 공간 가상주소를 리턴한다.

주석

NdisBufferVirtualAddress함수는 주어진 버퍼 디스크립터에의해 멥된 버퍼에대해 기본 가상 주소를 리턴한다. 만약 이러한 페이지가 이미 시스템 공간에 멥되지 않았다면 시스템 공간에 대한 주어진 버퍼 디스크립터에의해 설명된 물리 페이지를 멥한다.

PIO장치의 드라이버들은 시스템 공간 주소 범위로의 사용자 버퍼에대해 버퍼에 의해 설명되어진 가상 주소 범위로 전환하기위해 이루틴을 호출한다.

리턴된 기본 주소는 버퍼내에 가상 주소로써 같은 옵셋을 가지고 있다.

NdisBufferVirtualAddress함수의 호출자는 RQL <= DISPATCH_LEVEL에서 동작됭질수 있다. 그러나 IRQL DISPATCH_LEVEL에서 동작하는 호출자는 nonpaged 시스템 공간 주소를 맵하는 버퍼 디스크립터를 제공해야만한다. 버퍼 그자체는 nonpaged pool, 연속적인 메모리, 혹은 비케쉬하되는 메모리로부터 할다되어져야한다.