NdisReadEisaSlotInformationEx
TOC
Collapse the table of content
Expand the table of content
The document is archived and information here might be outdated

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

Show:
© 2016 Microsoft