This documentation is archived and is not being maintained.

NdisImmediateReadPciSlotInformation function

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)

See also

MiniportInitialize
NdisMPciAssignResources
NdisMQueryAdapter Resources
NdisOpenConfiguration
NdisReadPciSlotInformation

 

 

Send comments about this topic to Microsoft

Show: