NdisImmediateReadPciSlotInformation

NdisImmediateReadPciSlotInformation

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

NdisImmediateReadPciSlotInformation returns a specified range of PCI configuration information in a caller-supplied buffer.

Parameters

WrapperConfigurationContext

Specifies the handle passed to the caller’s MiniportInitialize function.

SlotNumber

Specifies the slot number of the NIC on the I/O bus.

Offset

Specifies the byte offset within the PCI configuration space at which to begin transferring the configuration information.

Buffer

Points to a caller-allocated buffer in which to return the requested configuration information.

Length

Specifies the size in bytes of the buffer at Buffer and, therefore, how many bytes of configuration information to return.

Return Value

NdisImmediateReadPciSlotInformation returns the number of bytes it wrote at Buffer.

Comments

NdisImmediateReadPciSlotInformation helps a miniport driver find a NIC that it supports on a PCI bus, possibly before MiniportInitialize calls the Ndis..Configuration functions to get configuration information stored in the registry. This function cannot be called after the driver has claimed hardware resources in the registry for its NIC with NdisMPciAssignResources.

NdisImmediateReadPciSlotInformation returns the same bus-relative PCI configuration information as NdisReadPciSlotInformation. However, callers of NdisReadPciSlotInformation pass the adapter handle, rather than the WrapperConfigurationContext handle that is valid only during NIC driver initialization.

Callers of NdisImmediateReadPciSlotInformation can run at IRQL <= DISPATCH_LEVEL. Usually, callers are running at IRQL PASSIVE_LEVEL.