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