NdisImmediateReadPciSlotInformation

ULONG NdisImmediateReadPciSlotInformation( IN NDIS_HANDLE WrapperConfigurationContext, IN ULONG SlotNumber, IN ULONG Offset, IN PVOID Buffer, IN ULONG Length );

NdisImmediateReadPciSlotInformation함수는 호출자 할당버퍼내에 지정한 범위의 PCI구성 정보를 리턴한다.

매개변수

WrapperConfigurationContext

호출자의 MiniportInitialize함수에게 넘기는 핸들을 지정한다.

SlotNumber

I/O버스의 닉의 슬롯넘버를 지정한다.

Offset

구성정보를 전달하기 시작하는 PCI구성 정보 공간내의 바이트 옵셋을 지정한다.

Buffer

요청한 구성 정보가 리턴되는 호출자 할당 버퍼의 포인터.

Length

Buffer의 버퍼바이트 크기 사이즈를 지정한다. 그래서 몇바이트의 구성정보를 리턴할것인지.

리턴값

NdisImmediateReadPciSlotInformation함수는 Buffer에 쓰여진 바이트수를 리턴한다.

주석

NdisImmediateReadPciSlotInformation함수는 미니포트 드라이버가 PCI버스에 지원하는 닉을 찾도록 도움을 준다. 가능하면 MiniportInitialize함수가 레지스트리에 저장된 구성정보를 얻기위해 Ndis..Configuration함수를 호출하기전에. 이 함수는 드라이버가 NdisMPciAssignResources함수로 닉에대한 레지스트리내의 하드웨어 리소스들을 요구한후에는 호출 될수 없다.

NdisImmediateReadPciSlotInformation함수는 NdisReadPciSlotInformation함수와 같은 버스관련 PCI구성 정보를 리턴한다. 그러나 NdisReadPciSlotInformation함수의 호출자는 닉 드라이버의 초기화 동안만 유효한 WrapperConfigurationContext핸들보다는 아답터 핸들을 넘긴다.

NdisImmediateReadPciSlotInformation함수의 호출자는 IRQL <= DISPATCH_LEVEL에서 동작할수 있다. 일반적으로 호출자들은 IRQL PASSIVE_LEVEL에서 동작하고 있다.