NdisMRegisterIoPortRange (Windows Embedded CE 6.0)

  • Article

1/6/2010

This function sets up driver access to device I/O ports with the NdisRawReadPortXXX and NdisRawWritePortXXX functions and claims the range of I/O port addresses in the registry for that driver's NIC.

Syntax

NDIS_STATUS NdisMRegisterIoPortRange(
  PVOID* PortOffset,
  NDIS_HANDLE MiniportAdapterHandle,
  UINT InitialPort,
  UINT NumberOfPorts
);

Parameters

  • PortOffset
    [out] Specifies a caller-supplied variable in which this function returns the mapped base virtual address for the specified bus-relative I/O port range specified by InitialPort and NumberOfPorts.
  • InitialPort
    [in] Specifies the bus-relative base port address for a range of ports to be mapped.
  • NumberOfPorts
    [in] Specifies the number of ports in the range to be mapped.

Return Value

The following table shows the return values for this function.

Value Description

NDIS_STATUS_SUCCESS

The specified range of I/O ports was mapped successfully; the value at PortOffset is valid, and the mapped range has been claimed in the registry for the NIC.

NDIS_STATUS_RESOURCE_CONFLICT

An attempt to claim the I/O port range in the registry has failed, possibly because another driver already claimed the range for its device. This function logs an error if this occurs.

NDIS_STATUS_RESOURCES

The port range could not be mapped, or NDIS could not allocate resources to check the registry for hardware-resource conflicts.

NDIS_STATUS_FAILURE

Either the bus type or bus number is out of range, or the specified InitialPort and NumberOfPorts were invalid, possibly not within the I/O port space of the current platform.

Remarks

An NIC driver calls this function from its MiniportInitialize function. MiniportInitialize must call NdisMSetAttributes or NdisMSetAttributesEx before calling this function.

This function maps a bus-relative device address range that the miniport can use subsequently to access an I/O port range on its NIC by calling the NdisRawXXX functions. A successful call claims the specified range of I/O ports in the registry for the caller's NIC.

If its call to this function fails, MiniportInitialize releases all resources that it has already allocated for its NIC, and then fails initialization for that NIC.

Drivers of NICs with device registers in the host memory space call NdisMMapIoSpace and, subsequently, the NdisRead/WriteRegisterXXX functions to access the NIC registers.

Requirements

Header ndis.h
Library ndis.dll
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

NDIS Library Functions
MiniportInitialize
NdisMMapIoSpace
NdisMSetAttributes
NdisMSetAttributesEx
NdisMDeregisterIoPortRange
NdisRawReadPortBufferUchar
NdisRawReadPortBufferUlong
NdisRawReadPortBufferUshort
NdisRawReadPortUchar
NdisRawReadPortUlong
NdisRawReadPortUshort
NdisRawWritePortUchar
NdisRawWritePortUlong
NdisRawWritePortUshort