NdisImmediateReadPciSlotInformation function

Article
06/19/2017

Note NDIS 5. x has been deprecated and is superseded by NDIS 6. x. For new NDIS driver development, see Network Drivers Starting with Windows Vista. For information about porting NDIS 5. x drivers to NDIS 6. x, see Porting NDIS 5.x Drivers to NDIS 6.0.

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

Syntax

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

Parameters

WrapperConfigurationContext [in]
Specifies the handle passed to the caller's MiniportInitialize function.
SlotNumber [in]
Reserved. NDIS ignores this parameter.
Offset [in]
Specifies the byte offset within the PCI configuration space at which to begin transferring the configuration information.
Buffer [in]
Pointer to a caller-allocated buffer in which to return the requested configuration information.
Length [in]
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.

Remarks

NdisImmediateReadPciSlotInformation helps a miniport driver find a NIC that it supports on a PCI bus, possibly before MiniportInitialize calls the NdisXxxConfiguration 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 NdisQueryAdapterResources or 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 must run at IRQL <= DISPATCH_LEVEL. Usually, callers are running at IRQL = PASSIVE_LEVEL.

Requirements

Target platform	Universal
Version	Not supported for NDIS 6.0 drivers in Windows Vista. Supported for NDIS 5.1 drivers in Windows Vista and Windows XP. Windows XP supports this function for legacy drivers. However, the Windows XP DDK will not build an NDIS driver that calls this function. Drivers should call NdisReadPciSlotInformationinstead.
Header	Ndis.h (include Ndis.h)
Library	Ndis.lib
IRQL	<= DISPATCH_LEVEL (See Remarks section)