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