NdisWritePciSlotInformation

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

NdisWritePciSlotInformation은 PCI 버스에 NIC을 위한 PCI 구성 공간에 특정 바이트 수를 쓴다.

매개변수

NdisAdapterHandle

대부분의 다른 MiniportXxx 함수들과 MiniportInitialize에 전달되는 MiniportAdapterHandle을 지정한다.

SlotNumber

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

Offset

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

Buffer

쓰여지는 PCI 구성 정보를 포함하는 호출자 할당 버퍼를 가리킨다.

Length

Buffer에 버퍼의 바이트들로 크기를 지정하고, 그러므로 쓰여지는 PCI 구성 정보의 바이트 크기를 지정한다.

리턴값

NdisWriteSlotInformation은 쓰여지는 호출자 제공 데이터가 얼마나 많은 바이트 수인가를 리턴한다.

주석

NdisWritePciSlotInformation은 NIC을 위해 PCI 구성 정보를 쓴다. 그러나 PCI 버스들에 있는 NIC들의 드라이버가 이 함수보다 더 자주 NdisImmediateReadPciSlotInformation, NdisReadPciSlotInformation 혹은 NdisMPciAssignResources를 호출한다.

NIC 드라이버는 Ndis(Immediate)ReadPciSlotInformation으로 PCI 버스에 장치를 발견하거나 혹은 \DriverName\Parameters 키에 레지스트리내에 있는 정보를 검색함으로써, 그러한 드라이버는 다른 NdisXxx 구성 함수들에 대한 계속적인 호출에서 사용할 수 있는 버스 관련 구성 매개변수들을 결정하기 위해 NdisMPciAssignResources를 호출할 수 있다. 만약 NdisMPciAssignResources 함수는 드라이버가 버스에 있는 장치를 재구성하기 위해 요구하는 값들을 리턴한다면은, NdisWritePciSlotInformation 함수를 호출할 수 있다.

NdisWritePciSlotInformation은 NdisImmediateWriteSlotInformation로서 버스 관련 PCI 구성 정보의 같은 타입을 전송한다. 그러나, NdisWritePciSlotInformation의 호출자들은 MiniportInitialize로 전달되어지는 MiniportAdapterHandle를 전달한다. WrapperConfigurationContext내보다 오히려.

호출자는 NdisWritePciSlotInformation가 제어를 리턴할 때 Buffer내에 메모리를 해제하는 책임이 있다.

NdisWritePciSlotInformation의 호출자들은 IRQL <= DISPATCH_LEVEL에서 실행할 수 있다. 항상 호출자들은 IRQL PASSIVE_LEVEL에서 실행한다.