Expandir Minimizar

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

NdisImmediateReadPortUlong reads a ULONG from a given bus-relative I/O port.

Syntax


VOID NdisImmediateReadPortUlong(
  _In_   NDIS_HANDLE WrapperConfigurationContext,
  _In_   ULONG Port,
  _Out_  PULONG Data
);

Parameters

WrapperConfigurationContext [in]

Specifies the handle input to MiniportInitialize.

Port [in]

Specifies the bus-relative I/O port address.

Data [out]

Pointer to a caller-supplied variable in which this function returns the value read from the I/O port.

Return value

None

Remarks

NdisImmediateReadPortUlong determines how the host accesses the given I/O port, maps the bus-relative port address, and then reads a ULONG-type value from the device.

A miniport driver can call NdisImmediateReadPortUlong during initialization to read data from a device I/O port when that driver has not yet called NdisMRegisterIoPortRange to obtain mapped device memory ranges. After its call to NdisMRegisterIoPortRange, the driver uses the faster NdisRawXxx functions to communicate with its NIC.

A miniport driver should not call NdisImmediateReadPortUlong in a Plug and Play environment.

Requirements

Version

Not supported for NDIS 6.0 drivers in Windows Vista. Supported for NDIS 5.1 drivers in Windows Vista and Windows XP. Windows XP supports this function for legacy drivers. However, the Windows XP DDK will not build an NDIS driver that calls this function. Drivers should call NdisReadPortUlonginstead.

Header

Ndis.h (include Ndis.h)

IRQL

PASSIVE_LEVEL

See also

MiniportInitialize
NdisImmediateReadPortUchar
NdisImmediateReadPortUshort
NdisImmediateWritePortUlong
NdisMRegisterIoPortRange
NdisRawReadPortUlong
NdisReadPortUlong

 

 

Send comments about this topic to Microsoft

Mostrar:
© 2014 Microsoft