Previous Next

NdisReadEisaSlotInformationEx

This function is obsolete for Windows XP and later, and is no longer supported.

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

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

Parameters

Status
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
Specifies the handle input to MiniportInitialize.
SlotNumber
Pointer to a variable in which this function returns the slot number for the NIC on the EISA bus.
EisaData
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
Pointer to a caller-supplied variable in which this function returns the number of EISA functions for which configuration information was gathered.

Headers

Declared in Ndis.h. Include Ndis.h.

Comments

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.

Callers of NdisReadEisaSlotInformationEx run at IRQL = PASSIVE_LEVEL.

See Also

MiniportInitialize, NdisMSetAttributes, NdisMSetAttributesEx, NdisReadEisaSlotInformation