NdisReadEisaSlotInformationEx 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.

NdisReadEisaSlotInformationEx returns EISA configuration information for a NIC on an EISA bus.

Syntax

VOID NdisReadEisaSlotInformationEx(
  _Out_ PNDIS_STATUS                    Status,
  _In_  NDIS_HANDLE                     WrapperConfigurationContext,
  _Out_ PUINT                           SlotNumber,
  _Out_ PNDIS_EISA_FUNCTION_INFORMATION *EisaData,
  _Out_ PUINT                           NumberOfFunctions
);

Parameters

  • Status [out]
    Pointer to a caller-supplied variable in which this function returns the status of the call as one of the following:

    • NDIS_STATUS_SUCCESS
      The NIC driver can examine the buffered configuration data to determine whether a NIC that it supports has been found and, if so, can use the bus-relative configuration values as parameters to certain NdisXxx initialization functions.

    • NDIS_STATUS_RESOURCES
      NDIS could not allocate a buffer to contain the requested EISA configuration information or could not allocate the resources it needs to collect the configuration information.

    • NDIS_STATUS_FAILURE
      This is a default status, returned if the caller supplied an invalid parameter. For example, if the caller set the AdapterType to something other than NdisInterfaceEisa when the miniport driver called NdisMSetAttributes or NdisMSetAttributesEx, NdisReadEisaSlotInformationEx returns this status.

  • WrapperConfigurationContext [in]
    Specifies the handle input to MiniportInitialize.

  • SlotNumber [out]
    Pointer to a variable in which this function returns the slot number for the NIC on the EISA bus.

  • EisaData [out]
    Pointer to a caller-supplied variable in which this function returns a pointer to the information it collected. A miniport driver should set the variable at EisaData to NULL before it calls NdisReadEisaSlotInformationEx.

  • NumberOfFunctions [out]
    Pointer to a caller-supplied variable in which this function returns the number of EISA functions for which configuration information was gathered.

Return value

None

Remarks

NdisReadEisaSlotInformationEx collects more bus-relative configuration information about a NIC on an EISA bus than NdisReadEisaSlotInformation if additional configuration data is available.

If the call to NdisReadEisaSlotInformationEx succeeds, this function returns the same EISA configuration information as NdisReadEisaSlotInformation followed by any additional NDIS_EISA_FUNCTION_INFORMATION-structured data that is available. See NdisReadEisaSlotInformation for more information about the NDIS_EISA_FUNCTION_INFORMATION structure. NdisReadEisaSlotInformationEx allocates a buffer large enough to contain the available configuration data and resets the variable at EisaData to the address of this buffer.

Requirements

Target platform

Universal

Version

Not supported for NDIS 6.0 drivers in Windows Vista. Obsolete for Windows XP.

Header

Ndis.h (include Ndis.h)

Library

Ndis.lib

IRQL

PASSIVE_LEVEL

See also

MiniportInitialize

NdisMSetAttributes

NdisMSetAttributesEx

NdisReadEisaSlotInformation

Send comments about this topic to Microsoft