NdisReadPciSlotInformation

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

NdisReadPciSlotInformation은 버스에서 특정 슬롯에서 장치를 위한 PCI 구성 공간으로부터 버스 특정 PCI 구성 정보를 리턴한다.

매개변수

NdisAdapterHandle

MiniportInitialize 와 다른 대부분의 MiniportXxx 함수들에게 전달되어지는 MiniportAdapterHandle를 지정한다.

SlotNumber

I/O 버스에서 NIC의 슬롯 넘버를 지정한다.

Offset

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

Buffer

요구된 구성 정보를 리턴하기 위해 호출자 할당 버퍼를 가리킨다.

Length

얼마나 많은 바이트의 구성 정보가 리턴되는지 Buffer의 바이트들인 크기를 지정한다.

리턴값

NdisReadPciSlotInformation은 Buffer에서 리턴되어지는 얼마나 구성 정보의 얼마나 많은 바이트가를 리턴한다.

주석

NdisReadPciSlotInformation함수는 드라이버가 PCI 버스를 통해 지원하는 NIC을 발견하도록 도운다. 발견했을 때 드라이버는 NdisMRegisterInterrupt, NdisMMapIoSpace, NdisMRegisterIoPortRange와 같은 다른 NdisXxx 구성 함수들에 대한 계속적인 호출에서 사용할 수 있는 버스 관련 구성 매개변수들을 결정하기 위해 NdisMPciAssignResources를 호출할 수 있다.

NdisReadPciSlotInformation은 NdisImmediateReadPciSlotInformation와 같이 버스 관련 PCI 구성 정보를 리턴한다. 그러나, NdisReadPciSlotInformation의 호출자들은 WrapperConfigurationContext 핸들보다는 오히려 MiniportInitialize 함수에 전달되어지는 MiniportAdapterHandle를 전달한다.

호출자는 드라이버가 NdisFreeMemory로 구성 정보를 소비할 때 Buffer에 메모리를 해제해야 할 책임이 있다.

Miniport 드라이버들은 그들의 MiniportInitialize 함수들로부터 이 함수를 호출한다.

NdisReadPciSlotInformation의 호출자들은 IRQL <= DISPATCH_LEVEL 에서 실행할 수 있다. 항상, 호출자들은 IRQL PASSIVE_LEVEL에서 실행하고 있다.