NdisReadEisaSlotInformationEx

NdisReadEisaSlotInformationEx

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

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

Parameters

Status

Points 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 called NdisMSetAttributes(Ex), NdisReadEisaSlotInformationEx returns this status.

WrapperConfigurationContext

Specifies the handle input to MiniportInitialize.

SlotNumber

Points to a variable in which this function returns the slot number for the NIC on the EISA bus.

EisaData

Points to a caller-supplied variable in which this function returns a pointer to the information it collected. A miniport should set the variable at EisaData to NULL before it calls NdisReadEisaSlotInformationEx.

NumberOfFunctions

Points to a caller-supplied variable in which this function returns the number of EISA functions for which configuration information was gathered.

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 these NDIS_EISA_XXX structures. 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.