NdisReadPcmciaAttributeMemory

ULONG NdisReadPcmciaAttributeMemory( IN NDIS_HANDLE NdisAdapterHandle, IN ULONG Offset, IN PVOID Buffer, IN ULONG Length );

NdisReadPcmciaAttributeMemory 함수는 속성 메모리로부터 PC 카드 NIC에 대한 버스관련 구성 매개변수를 읽는다.

매개변수

NdisAdapterHandle

NDIS가 MiniportInitialize 함수로의 입력 매개변수로써 전달하는 핸들을 서술한다.

Offset

읽기를 시작하는 시점에서 이상한 수의 바이트는 제외하고 속성 메모리의 시작으로부터 바이트 옵셋을 서술한다.

Buffer

PC 카드 속성 메모리로부터 특정 바이트 수가 복사되는 이 함수의 호출자 할당 버퍼를 가리킨다.

Length

Offset의 시작에서 속성 메모리로부터 읽은 짝수의 바이트 수를 서술한다.

주석

PC 카드 NIC의 드라이버는 PC카드 속성 메모리로부터 NIC에 대한 버스관련 구성 매개변수를 읽기 위해서 NdisReadPcmciaAttributeMemory 함수를 호출한다. 그러한 미니포트는 MiniportInitialize 함수로부터 NdisReadPcmciaAttributeMemory 함수를 호출한다. 미니포트는 속성 메모리의 오버랩되지 않은 섹션을 읽기 위해서 NdisReadPcmciaAttributeMemory 함수를 한번이상 호출할 수 있다.

PC 카드 NIC의 드라이버는 Win32를 지원하는 MS사의 운영체제에서는 이진 호환을 유지하기 위해서 NdisReadPcmciaAttributeMemory 함수를 사용해야한다. 드라이버는 버스로부터 직접 속성 메모리를 읽을 시도를 하지 말아야한다.

PC 카드 속성 메모리는 짝수의 바이트에서만 중요한 정보를 포함한다. 그러므로 NdisReadPcmciaAttributeMemory 함수는 모든 의미없는 바이트는 제거하고 안정화된 것처럼 속성 메모리를 다룬다. Offset과 Length 매개변수는 안정화된 메모리(짝수의 바이트로만 구성된 메모리)를 취급한다. 예를들어 0xFF0의 실제 옵셋에서 속성 메모리로부터 6 바이트의 이더넷 주소를 읽기 위해서 NdisWritePcmciaAttributeMemory 함수의 호출자는 Offset을 0x7F8 (0xFF0/2)로 서술하고 Length를 6으로 서술해야한다.

NdisWritePcmciaAttributeMemory 함수의 호출자는 IRQL <= DISPATCH에서 실행한다.