2.1 NDIS Library Functions Used by Miniport Drivers
Copies a given Ethernet address to a given location.
FDDI_COMPARE_NETWORK_ADDRESSES
Sets a caller-supplied variable to a value indicating whether a given FDDI address is greater than, less than, or equal to another given FDDI address.
Sets a caller-supplied variable to a Boolean value indicating whether a given FDDI address is a broadcast address.
Sets a caller-supplied variable to a Boolean value indicating whether a given FDDI address is a multicast address.
Sets a caller-supplied variable to a Boolean value indicating whether a given FDDI frame is SMT (systems management utility).
Acquires a spin lock so the caller can synchronize access to resources shared among nonISR driver routines in a multiprocessor-safe way.
Modifies the length specified in a given buffer descriptor that was allocated or copied by the caller.
Creates a buffer descriptor describing a specified virtual (sub)range within an already allocated, nonpaged memory block, given a handle returned by NdisAllocateBufferPool.
Returns a handle with which the caller can allocate buffer descriptors with NdisAllocateBuffer.
Allocates resident (nonpaged) system-space memory, optionally within a specified address limit, as a physically contiguous allocation, and/or as a noncached allocation.
Allocates a packet descriptor, given a handle returned by a preceding call to NdisAllocatePacketPool.
Allocates and initializes a block of nonpaged packet pool, given the number of packet descriptors and how many bytes each fixed-size packet descriptor should contain.
Initializes a variable of type NDIS_SPIN_LOCK, used to synchronize access to resources shared among nonISR driver functions. An initialized spin lock, for which the caller supplies resident storage, is a required parameter to the Ndis..SpinLock and NdisInterlockedXxx functions.
Converts a given counted ANSI string into a counted Unicode string.
Returns a pointer to a linked buffer, given a pointer to an NDIS buffer descriptor.
Determines how many pages of host memory are being used to back a given buffer.
Links a given buffer descriptor at the end of the chain of buffer descriptors for a given packet descriptor.
Links a given buffer descriptor at the start of the chain of buffer descriptors for a given packet descriptor.
Releases the handle returned by NdisOpenConfiguration after the caller has retrieved configuration information for a NIC or itself and/or, possibly, stored additional information about its NIC in the registry.
Releases a handle returned by NdisOpenFile and frees the memory allocated to hold the file contents when it was opened.
Creates a buffer descriptor for a specified virtual (sub)range, given a handle for a block of already allocated memory and a pointer to the buffer descriptor for the block.
Copies a specified number of bytes of data from one packet to another, starting at a specified offset in a given source packet’s data and copying the data to a specified offset in the target packet. Returns the number of bytes actually copied, which can be less than the requested number, depending on the source packet and specified starting offset for the copy operation.
NdisCreateLookaheadBufferFromSharedMemory
Returns the virtual address of a buffer within a block of memory shared with a busmaster DMA NIC so the caller can set up a read-only lookahead buffer for a receive indication to higher-level drivers.
NdisDestroyLookaheadBufferFromSharedMemory
Releases access to the buffer obtained in the preceding call to NdisCreateLookaheadBufferFromSharedMemory.
Acquires a spin lock so the caller can synchronize access to resources shared among nonISR driver functions in a multiprocessor-safe way, provided that the caller is running at IRQL DISPATCH_LEVEL.
Allocates and initializes a packet descriptor when the caller is running at IRQL DISPATCH_LEVEL, given a handle returned by a preceding call to NdisAllocatePacketPool.
Releases a driver-allocated packet descriptor and returns it to the free list when the caller is running at IRQL DISPATCH_LEVEL.
Releases a spin lock that was acquired in a preceding call to NdisDprAcquireSpinLock.
Compares two strings to determine whether they are equal.
Flushes the memory region described by a given buffer descriptor from all processor caches.
Releases a buffer descriptor obtained in a preceding call to NdisAllocateBuffer or NdisCopyBuffer.
Releases a handle obtained in a preceding call to NdisAllocateBufferPool.
Releases a handle, usually when the driver is being unloaded, that was obtained in a preceding call to NdisAllocateMemory.
Releases a packet descriptor that was allocated from packet pool with NdisAllocatePacket and returns it to the free list.
Releases a handle to a block of packet pool that was allocated with NdisAllocatePacketPool.
Releases a spin lock initialized in a preceding call to NdisAllocateSpinLock, usually when a driver is unloading.
Frees the storage for a buffered string.
NdisGetBufferPhysicalArraySize
Returns the number of discontiguous physical blocks in a buffer, given a buffer descriptor.
Returns the size of the microprocessor cache boundary in bytes. (This information is useful primarily to drivers of busmaster DMA NICs.)
NdisGetCurrentProcessorCpuUsage
Returns how busy the current processor is as a percentage.
Returns the current system time, suitable for use as a timestamp.
Returns pointers to the buffer descriptor and base virtual address for the initial buffer chained to a given packet, along with the sizes of the initial buffer and full buffer, in case the buffer is fragmented.
Returns the next buffer descriptor in a chain, given the current buffer descriptor.
Returns the flags, if any, set by a protocol driver in a given packet descriptor.
NDIS_GET_PACKET_MEDIA_SPECIFIC_INFO
Returns the address (MediaSpecificInformation) and length (SizeMediaSpecificInfo) from the NDIS_PACKET_OOB_DATA block associated with the packet descriptor of a buffer containing out-of-band information, such as packet priority, about a given send packet set up by a protocol.
Returns the Status of an indicated receive packet on return from NdisMIndicateReceivePacket so the driver can determine whether its miniport-allocated packet descriptor (and chained buffer descriptors) can be prepared for reuse immediately.
Returns the protocol-set TimeToSend timestamp, directing the miniport when to send the given packet, from the NDIS_PACKET_OOB_DATA block associated with the incoming packet descriptor.
Returns the high-order part of a given physical address.
Returns the low-order part of a given physical address.
NdisIMDeInitializeDeviceInstance
Calls an NDIS intermediate driver's MiniportHalt function to tear down the driver's virtual NIC.
NdisIMInitializeDeviceInstance
Calls an NDIS intermediate driver’s MiniportInitialize function to set up the driver’s virtual NIC for I/O operations bound for an underlying NIC driver to which the intermediate driver is bound.
NdisImmediateReadPciSlotInformation
Returns a specified range of PCI configuration information to a caller-supplied buffer, given a handle to the wrapper configuration context and the slot number for the NIC on the I/O bus.
Reads a byte from a specified port on an I/O bus during driver initialization, given the handle to the wrapper configuration context. If necessary, this function maps the specified bus-relative port address in order to read the data.
Reads a ULONG from a specified port on an I/O bus during driver initialization, given a handle to the wrapper configuration context. If necessary, this function maps the specified bus-relative port address in order to read the data.
Reads a USHORT from a specified port on an I/O bus during driver initialization, given a handle to the wrapper configuration context. If necessary, this function maps the specified bus-relative port address in order to read the data.
Reads a specified number of bytes into a caller-supplied buffer from shared device RAM, given the base physical address for the shared memory and a handle to the wrapper configuration context. If necessary, this function maps the specified bus-relative memory range in order to read the data.
NdisImmediateWritePciSlotInformation
Writes data from a caller-supplied buffer to a specified range of the PCI configuration space, given a handle to the wrapper configuration context and the slot number for the NIC on the I/O bus.
Writes a byte to a specified port on an I/O bus during driver initialization, given the handle to the wrapper configuration context. If necessary, this function maps the specified bus-relative port address in order to write the data.
Writes a ULONG to a specified port on an I/O bus during driver initialization, given the handle to the wrapper configuration context. If necessary, this function maps the specified bus-relative port address in order to write the data.
Writes a USHORT to a specified port on an I/O bus during driver initialization, given the handle to the wrapper configuration context. If necessary, this function maps the specified bus-relative port address in order to write the data.
NdisImmediateWriteSharedMemory
Writes a specified number of bytes from a caller-supplied buffer to shared device RAM, given the base physical address for the shared memory and a handle to the wrapper configuration context. If necessary, this function maps the specified bus-relative memory range in order to write the data.
Calls an intermediate driver’s callback function to when it can execute in a MiniportXxx context, as, for example, to forward an indication to higher-level protocols.
Registers an NDIS intermediate driver’s MiniportXxx entry points and name with the NDIS library when the driver initializes.
Returns the function of an intermediate driver to the context in which it was executing before it called NdisIMSwitchToMiniport.
Allows an intermediate driver function to call NdisMXxx normally called only from MiniportXxx functions, as, for example, to make indications up to higher-level protocols.
Initializes a counted ANSI string.
Marks a given driver function as initialization-only code to be discarded after the function has run once.
Sets up an event object during driver initialization to be used subsequently as a synchronization mechanism.
Sets up a queue header for a driver’s internal queue, given a pointer to driver-supplied resident storage for the queue header and queue. Then, entries (usually packets) can be added to and removed from the doubly-linked queue with the NdisInterlocked..List functions.
Allocates a buffer for and initializes a counted string in the system-default character set, given a source string and a NULL pointer.
Initializes a counted Unicode string.
Adds an unsigned long value to a given unsigned integer as an atomic operation, using a caller-supplied and initialized spin lock.
Inserts an entry, usually a packet, at the head of a doubly linked list using a caller-supplied and initialized spin lock so that access to queued entries is synchronized in a multiprocessor-safe way among nonISR driver functions.
Inserts an entry, usually a packet, at the end of a doubly linked list using a caller-supplied and initialized spin lock so that access to queued entries is synchronized in a multiprocessor-safe way among nonISR driver functions.
Removes an entry, usually a packet, from the head of a doubly linked list using a caller-supplied and initialized spin lock so that access to queued entries is synchronized in a multiprocessor-safe way among nonISR driver functions.
Reserves system resources during NIC driver initialization for subsequent busmaster DMA operations.
Allocates and maps a memory range so it is simultaneously accessible from both the system and a busmaster DMA device, given the MiniportAdapterHandle for the NIC input to MiniportInitialize, the number of bytes to be allocated, and whether the memory should be cached. Returns the base (system) virtual address of the allocation for use by the miniport and a mapped base logical address for use by the NIC.
NdisMAllocateSharedMemoryAsync
Allocates additional memory shared between a miniport and its busmaster DMA NIC, usually when the miniport is running low on available receive buffers.
Maps the contents of an already open file to a caller-accessible buffer if the file currently is unmapped, given a handle returned by NdisOpenFile.
Notifies NDIS that an ARCNET packet is being received on a particular NIC, identified by the adapter handle, and that the packet or some initial lookahead portion of the packet, along with the packet header, is available to be forwarded to the appropriate bound protocol driver(s).
NdisMArcIndicateReceiveComplete
Notifies NDIS that an ARCNET receive packet, identified in a preceding call to NdisMArcIndicateReceive, has been fully transferred through a particular NIC, identified by the given adapter handle, so that NDIS can notify the appropriate bound protocol driver(s).
Cancels a preceding call to NdisMSetPeriodicTimer or cancels the immediately preceding call to NdisMSetTimer if the interval given to NdisMSetTimer has not yet expired.
Releases resources allocated when the driver called NdisMCreateLog.
NdisMCompleteBufferPhysicalMapping
Flushes any data remaining in a busmaster NIC’s internal cache at the end of a transfer operation that was set up with NdisMStartBufferPhysicalMapping.
Completes a system DMA transfer operation begun with a preceding call to NdisMSetupDmaTransfer, ensuring that the data is flushed to system memory or to the NIC, depending on the transfer direction.
Allocates and opens a log file in which a NIC miniport can write data to be displayed by a driver-dedicated Win32 application.
NdisMDeregisterAdapterShutdownHandler
Removes a driver-supplied MiniportShutdown function when the driver is unloading from the set of shutdown handlers that were registered with NdisMRegisterAdapterShutdownHandler.
Releases DMA system resources, including claimed hardware resources in the registry, that were acquired with NdisMRegisterDmaChannel. Drivers call NdisMDeregisterDmaChannel when they are unloading.
Releases the mapping created with an initialization-time call to NdisMRegisterInterrupt. Drivers call NdisMDeregisterInterrupt when they are unloading.
Releases a mapping that was set up with NdisMRegisterIoPortRange during driver initialization.
Notifies NDIS that an Ethernet packet is being received on a particular NIC, identified by the adapter handle, and that the packet or some initial lookahead portion of the packet, along with the packet header, is available to be forwarded to the appropriate bound protocol driver(s).
NdisMEthIndicateReceiveComplete
Notifies NDIS that an Ethernet receive packet, identified in a preceding call to NdisMEthIndicateReceive, has been fully transferred through a particular NIC, identified by the given adapter handle, so that NDIS can notify the appropriate bound protocol driver(s).
Notifies NDIS that an FDDI packet is being received on a particular NIC, identified by the adapter handle, and that the packet or some initial lookahead portion of the packet, along with the packet header, is available to be forwarded to the appropriate bound protocol driver(s).
NdisMFddiIndicateReceiveComplete
Notifies NDIS that an FDDI receive packet, identified in a preceding call to NdisMFddiIndicateReceive, has been fully transferred through a particular NIC, identified by the given adapter handle, so that NDIS can notify the appropriate bound protocol driver(s).
Clears a miniport’s log file that was allocated with NdisMCreateLog.
Releases system resources for busmaster DMA that were reserved with NdisMAllocateMapRegisters. Drivers call NdisMFreeMapRegisters when they are unloading or during initialization if they fail to successfully initialize a NIC.
Releases a block of memory that was allocated with NdisMAllocateSharedMemory. Drivers call NdisMFreeSharedMemory when they are unloading or during initialization if they fail to successfully initialize a NIC.
Notifies NDIS that an array of received packets is available to be forwarded to the appropriate bound protocol driver(s).
Notifies NDIS of a change in the runtime status of a NIC that might be corrected with a reset operation or possibly even require the NIC to be taken out of service, depending on the given NDIS_STATUS_XXX and additional driver-supplied information.
Notifies NDIS that the driver, which has previously called NdisMIndicateStatus one or more times to indicate hardware anomalies or runtime state changes in the NIC, is ready to resume normal device I/O operations.
Sets up a caller-supplied MiniportTimer function to be associated with a timer object during driver initialization; returns a handle at the caller-supplied resident storage for the timer object. This handle is a required parameter to all other NdisM..Timer functions.
Notifies NDIS that a new NIC driver is initializing and returns a WrapperConfigurationContext handle to be passed in subsequent calls to NdisXxx initialization and configuration functions.
Maps a given bus-relative “physical” range of device memory, such as on-board device RAM or a set of NIC registers, onto system-space nonpaged pool and returns the mapped virtual base address for subsequent use in PIO operations.
Copies data from device memory that was mapped with NdisMMapIoSpace to a system-space buffer.
Copies data from one location to another in a memory block that was mapped with NdisMMapIoSpace.
Copies a specified number of bytes from one caller-supplied location to another.
Copies data from a system-space buffer to device memory that was mapped with NdisMMapIoSpace.
Claims resources in the registry for the caller and returns the hardware configuration information for a PCI NIC, given a handle passed in to the MiniportInitialize function and the slot number of its NIC on the PCI bus.
Either returns a list of PCMCIA resources used by a NIC or returns NDIS_STATUS_NOT_SUPPORTED.
Returns the final status of a query-information request for which the driver previously returned NDIS_STATUS_PENDING.
Returns the number of bytes remaining to be transferred during a DMA operation if the NIC uses the host DMA controller’s autoinitialize mode, given a handle returned by NdisMRegisterDmaChannel.
NdisMRegisterAdapterShutdownHandler
Registers a driver-supplied MiniportShutdown function to be called with a pointer to a caller-supplied context buffer when the system is about to be shut down, given a handle passed in to the MiniportInitialize function. Such a MiniportShutdown function restores the NIC to its initial state.
Reserves system resources during driver initialization for subsequent slave DMA operations or ISA busmaster DMA operations and claims a DMA channel in the registry, returning a handle to be passed in subsequent calls to the NdisMXxx DMA functions.
Sets up a mapping between the miniport’s ISRHandler and HandleInterruptHandler (DPC) functions, already registered with NdisMRegisterMiniport, and the bus-relative vector (or level) on which its NIC interrupts, given a pointer to caller-allocated storage for opaque interrupt state and the adapter handle for the NIC. The interrupt handle initialized in this call is a required parameter to NdisMSynchronizeWithInterrupt.
Claims a range of device memory in the registry and maps a given bus-relative range of I/O ports to a range of system logical addresses during initialization, which the driver can pass in subsequent calls to the NdisRawXxx to communicate with its NIC.
Registers a miniport’s entry points and name with the NDIS library, given a handle obtained from NdisMInitializeWrapper and a pointer to the NDIS_MINIPORT_CHARACTERISTICS structure set up by the caller.
Returns the final status of a reset request for which the driver previously returned NDIS_STATUS_PENDING and indicates whether the reset operation on the NIC affected its network address information.
Returns the packet and final status of a completed send request for which the driver previously returned NDIS_STATUS_PENDING, so that NDIS can return the completed packet to the appropriate bound protocol driver(s).
Notifies NDIS that the driver has internal resources available to process another send request when the driver has an outstanding send request for which it returned NDIS_STATUS_PENDING but has not yet called NdisMSendComplete.
Informs the NDIS library about significant features of the caller’s NIC, such as whether it is a busmaster and the type of I/O bus on which the NIC can be found, so the miniport can call other NdisXxx initialization and configuration routines, particularly the NdisRegisterXxx. NIC drivers can call this function or NdisMSetAttributesEx. Intermediate drivers must call NdisMSetAttributesEx.
Informs the NDIS library about significant features of the caller’s NIC, such as whether it is a busmaster and the type of I/O bus on which the NIC can be found, so the miniport can call other NdisXxx initialization and configuration routines, particularly the NdisRegisterXxx. In addition, this function prevents NDIS from timing out sends and requests in an intermediate driver or optionally resets the interval at which a NIC driver’s MiniportCheckForHang function is called.
Returns the final status of a set-information request for which the driver previously returned NDIS_STATUS_PENDING.
Sets a timer to fire periodically, thereby running an associated MiniportTimer function repeatedly at a specified fixed interval.
Sets a caller-initialized timer object to a specified interval, thereby running an associated MiniportTimer function once when the given interval expires.
Sets up the host DMA controller to transfer a specified range of data from a given buffer, given the handle returned by a preceding call to NdisMRegisterDmaChannel and the transfer direction.
Delays execution of the caller for a given interval in microseconds.
NdisMStartBufferPhysicalMapping
Sets up a busmaster NIC for a DMA transfer operation, given the adapter handle for the NIC, the direction of the transfer, a pointer to the buffer descriptor, an index to the initial map register, a pointer to caller-allocated memory for a variable-size array of NDIS_PHYSICAL_UNIT structures, and the number of elements in the array.
Synchronizes the execution of a caller-supplied MiniportSynchronizeISR function with that of the ISR associated with the given initialized interrupt handle. When it runs, the supplied function can access data shared with the ISR in a multiprocessor-safe way.
Notifies NDIS that a Token Ring packet is being received on a particular NIC, identified by the adapter handle, and that the packet or some initial lookahead portion of the packet, along with the packet header, is available to be forwarded to the appropriate bound protocol driver(s).
NdisMTrIndicateReceiveComplete
Notifies NDIS that a Token Ring packet, identified in a preceding call to NdisMTrIndicateReceive, has been fully transferred through a particular NIC, identified by the given adapter handle, so that NDIS can notify the appropriate bound protocol driver(s).
Returns the packet and final status of a completed transfer-data request for which the driver previously returned NDIS_STATUS_PENDING and returns the number of bytes actually transferred.
Releases a mapping obtained with NdisMMapIoSpace, usually when a driver is unloading.
Ensures that data read from shared memory is current when the busmaster NIC has just written data to shared memory on platforms that require explicit coherency support from the system.
Transfers miniport-supplied information into its log file for consumption and display by a driver-dedicated Win32 application.
Returns a pointer to the NDIS_PACKET_OOB_DATA block associated with a given packet descriptor.
Returns a handle for a miniport’s HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services
\DriverName\Parameters registry key. This handle is a required parameter to other NdisXxx configuration functions.
Returns a handle for an opened file, given its name and the highest acceptable address at which to allocate memory for the file data. The returned handle is a required parameter to NdisMapFile, which gives the caller exclusive access to the file data until it calls NdisUnmapFile.
Marks a driver function as pageable code.
Initializes a constant of type NDIS_PHYSICAL_ADDRESS.
Displays a given string in the debugging window.
Retrieves the size of the range, and optionally its base virtual address, specified in a given buffer descriptor.
Retrieves the base virtual address of the range specified in a given buffer descriptor.
Returns the maximum number of available map registers in the current platform so the driver of a busmaster DMA NIC can call NdisMAllocateMapRegisters with an appropriate value during initialization.
Returns any or all of the following information about a given packet descriptor: a count of buffer descriptors chained to the packet descriptor, the total number of bytes in all buffers mapped by the buffer descriptor chained to the packet descriptor, the total number of physically discontiguous blocks for all such buffers, and a pointer to the initial buffer descriptors in the chain.
NdisQuerySendFlags
See NdisGetPacketFlags.
Reads a specified number of bytes into a caller-supplied buffer, given an I/O port mapped during initialization with NdisMRegisterIoPortRange.
Reads a specified number of ULONGs into a caller-supplied buffer, given an I/O port mapped during initialization with NdisMRegisterIoPortRange.
Reads a specified number of USHORTs into a caller-supplied buffer, given an I/O port mapped during initialization with NdisMRegisterIoPortRange.
Reads a byte from a given I/O port mapped during initialization with NdisMRegisterIoPortRange.
Reads a ULONG from a given I/O port mapped during initialization with NdisMRegisterIoPortRange.
Reads a USHORT from a given I/O port mapped during initialization with NdisMRegisterIoPortRange.
Writes a specified number of bytes from a caller-supplied buffer to a given I/O port mapped during initialization with NdisMRegisterIoPortRange.
Writes a specified number of ULONGs from a caller-supplied buffer to a given I/O port mapped during initialization with NdisMRegisterIoPortRange.
Writes a specified number of USHORTs from a caller-supplied buffer to a given I/O port mapped during initialization with NdisMRegisterIoPortRange.
Writes a given byte to a given I/O port mapped during initialization with NdisMRegisterIoPortRange.
Writes a given ULONG to a given I/O port mapped during initialization with NdisMRegisterIoPortRange.
Writes a given USHORT to a given I/O port mapped during initialization with NdisMRegisterIoPortRange.
Reads the value of a named entry of the specified type, given the registry handle for the caller’s Parameters key returned by NdisOpenConfiguration.
Returns EISA configuration information to a caller-supplied buffer during initialization, given a handle to the wrapper configuration context and the slot number for the NIC on the I/O bus.
Returns EISA configuration information, including all available EISA function information, to a caller-supplied buffer during initialization, given a handle to the wrapper configuration context and the slot number for the NIC on the I/O bus.
Returns POS configuration information to a caller-supplied buffer during initialization, given a handle to the wrapper configuration context and the channel number for the NIC on the I/O bus.
Returns the size and value, in binary, of the NetworkAddress entry, specifying the setup-configured network address of the NIC, from the caller’s Parameters key in the registry, given the handle obtained from NdisOpenConfiguration.
Returns a specified range of PCI configuration information to a caller-supplied buffer during initialization, given an adapter handle and the slot number for the NIC on the I/O bus.
Reads a byte from a device register, given its mapped memory-space address.
Reads a ULONG from a device register, given its mapped memory-space address.
Reads a USHORT from a device register, given its mapped memory-space address.
Resets the valid counts of chained buffer descriptors for a given packet descriptor.
Sets to NULL the queue head for any chained buffers in a given packet descriptor and reinitializes it for reuse.
Releases a spin lock that was acquired in a preceding call to NdisAcquireSpinLock.
Clears the Signaled state of a given event.
Retrieves a ULONG value from the source address, avoiding alignment faults.
Sets a given event to the Signaled state if it was not already Signaled, thereby causing waits on the event to be satisfied.
Sets the HeaderSize in the NDIS_PACKET_OOB_DATA block associated with a miniport-allocated packet descriptor for received net packet(s) to be indicated.
NDIS_SET_PACKET_MEDIA_SPECIFIC_INFO
Sets the MediaSpecificInformation and SizeMediaSpecificInfo in the NDIS_PACKET_OOB_DATA block associated with a miniport-allocated packet descriptor for a received net packet about to be indicated.
Sets the Status in the NDIS_PACKET_OOB_DATA block associated with packet descriptor for a received net packet about to be indicated or for a given send packet completed in the MiniportSend(Packets) function.
Sets the TimeReceived in the NDIS_PACKET_OOB_DATA block associated with a miniport-allocated packet descriptor for a received net packet about to be indicated with NdisMIndicateReceivePacket.
Sets the TimeSent in the NDIS_PACKET_OOB_DATA associated with a miniport-allocated packet descriptor for a received net packet about to be indicated with NdisMIndicateReceivePacket.
Sets the high-order part of a given physical address to a given value.
Sets the low-order part of a given physical address to a given value.
Stalls the caller on the current processor for a given interval in microseconds.
Stores a ULONG value at a particular address, avoiding alignment faults.
Determines whether its caller is running on a uniprocessor or multiprocessor machine, which is useful information for allocating resources during driver initialization.
Releases system resources allocated when the driver called NdisInitializeWrapper. Drivers call NdisTerminateWrapper during initialization if they cannot find and successfully initialize at least one NIC or when they are unloading.
Removes a given buffer descriptor at the end of the chain of buffer descriptors for a given packet descriptor and returns a pointer to the buffer descriptor.
Removes a given buffer descriptor at the start of the chain of buffer descriptors for a given packet descriptor and returns a pointer to the buffer descriptor.
Converts a given counted Unicode string into a counted ANSI string.
Releases the file mapping set up by the preceding call to NdisMapFile.
Puts the caller into a wait state until the given event is set to the Signaled state or the wait times out.
Writes a caller-supplied value entry in the registry, given the handle for the caller’s Parameters key returned by NdisOpenConfiguration
Allocates an error-log record, fills it in, and writes it to the I/O error log, given the adapter handle for the NIC, an NDIS_XXX error code, a count of caller-supplied error values, and a corresponding number of ULONGs specifying additional information about the I/O error or configuration error.
Writes data from a caller-supplied buffer to a specified range of the PCI configuration space, given a handle to the adapter and the slot number for the NIC on the I/O bus.
Writes a given byte to a device register, given its mapped memory-space address.
Writes a given ULONG to a device register, given its mapped memory-space address.
Writes a given USHORT to a device register, given its mapped memory-space address.
Fills a block of memory that was mapped in a preceding call to NdisMapIoSpace with zeros, given a pointer to the block and the length in bytes to be filled.
Fills a block of memory with zeros, given a pointer to the block and the length in bytes to be filled.
Sets a caller-supplied variable to a value indicating whether a given Token Ring address is greater than, less than, or equal to another given Token Ring address.
Copies a given Token Ring address to a given location.
Sets a caller-supplied variable to a Boolean value indicating whether a given Token Ring address is a broadcast address.
Sets a caller-supplied variable to a Boolean value indicating whether a given Token Ring address is a functional address.
Sets a caller-supplied variable to a Boolean value indicating whether a given Token Ring address is a group address.
Sets a caller-supplied variable to a Boolean value indicating whether a given Token Ring address is neither a functional nor a group address.
Sets a caller-supplied variable to a Boolean value indicating whether a given Token Ring address is a source-routing address.
To ensure their portability across Microsoft operating systems that support Win32, most NDIS miniport drivers call only functions exported by the NDIS library and use only macros explicitly declared in the master header file, ndis.h, or in the appropriate efilter.h, ffilter.h, tfilter.h, or afilter.h, if the NDIS uses the system-supplied Ethernet, FDDI, Token Ring, or ARCNET filter-library support to manage bindings for the miniport.
However, in addition to the NDIS library functions listed here, a miniport driver might use some of the macros and support routines exported by other Windows NT kernel-mode components, such as the following:
CONTAINING_RECORD
InitializeListHead
InsertHeadList
InsertTailList
IsListEmpty
RemoveEntryList
RemoveHeadList
For more information about the preceding Windows NT macro and functions, see the Kernel-Mode Driver Reference.