NdisAllocateMemoryWithTag

NDIS_STATUS NdisAllocateMemoryWithTag( OUT PVOID *VirtualAddress, IN UINT Length, IN ULONG Tag );

NdisAllocateMemoryWithTag 함수는 상주(비페이지화된) 시스템 공간 메모리를 할당한다.

매개변수

VirtualAddress

이 함수가 할당된 메모리의 베이스 가상 주소를 리턴하는 호출자 제공 변수를 가리킨다. 혹은 만약 충분한 비페이지화된 메모리가 현재 이용할 수 없다면은 NULL이다.

Length

할당된 바이트로 크기를 지정한다.

Tag

작은 따옴표(quote marks)에 의해 분리되고, 4개의 문자들까지, 항상 역순으로 지정되어지는 문자열이다. 이러한 호출을 위한 NDIS 제공 디폴트 태그는 'maDN'이지만은 호출자는 외연적인(다른) 값을 제공함으로써 이러한 디폴트를 오버라이드할 수 있다.

리턴값

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

NDIS_STATUS_SUCCESS

호출자는 VirtualAddress로 리턴되는 값으로 시작하는 할당된 메모리 범위를 사용할 수 있다.

NDIS_STATUS_FAILURE

요구된 메모리를 할당하기 위한 시도가 실패이다. 이러한 리턴은 반드시 연속된 호출이 실패할 것이다라는 것을 의미하지는 않는다.

주석

NdisAllocateMemoryWithTag 에 대한 호출은 NdisAllocateMemoryWithTag가 계속적으로 나타나는 시스템의 어떤 클래쉬 덤프에서 나타나는 태그를 호출자에게 제공하는 것을 허락하는 것을 제외하고는 NdisAllocateMemory를 호출하는 것과 동등하다.

시스템의 checked 빌드로 드라이버 개발하는 동안, 이러한 함수는 또한 크래쉬 디버깅을 위해 유용할 수 있다. NdisAllocateMemory보다 오히려 이러한 루틴을 호출하는 것은 호출자 제공 태그는 pool memory의 클래쉬 덤프로 삽입한다.

이 함수에 전달되는 태그는 만약 NdisAllocateMemoryWithTag가 호출되어질 때 문자들을 역순으로 한다면은, 더 읽기 좋을 것이다. 예를 들어, 호출자가 태그로서 'Fred'를 전달한다면은, 만약 pool이 덤프되거나 혹은 디버거에서 pool 사용을 트랙킹할 때(추적할 때) 'derF'로서 나타날 것이다. NDIS 제공 디폴트 태그는 pool이 덤프될 때 'NDam' (NDIS allocate memory를 가리키는)로서 나타난다.

NdisAllocateMemoryWithTag의 호출자들은 IRQL <= DISPATCH_LEVEL에서 실행될 것이다.