NdisMPciAssignResources (Windows CE 3.0 Device Driver Developement)

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function returns a list of bus-relative hardware resources, such as IRQ, I/O ports, and device memory ranges, claimed in the registry for a PCI NIC.

NDIS_STATUS NdisMPciAssignResources(
IN NDIS_HANDLE
MiniportHandle
,
IN ULONG
SlotNumber
,
OUT PNDIS_RESOURCE_LIST *
AssignedResources
);

Parameters

MiniportHandle

Specifies the MiniportAdapterHandlepassed in to the MiniportInitializefunction and to most other Miniport XXXfunctions.

SlotNumber

Specifies the slot number of the driver's NIC on the PCI bus.

AssignedResources

Pointer to a list of the hardware resources that the NIC can use.

Return Values

Returns NDIS_STATUS_SUCCESS.

Remarks

This function claims a set of hardware resources in the registry for a miniport's PCI NIC to use, thus preventing conflicting claims on the same resources from other devices in the computer.

The buffer specified at AssignedResourcesis formatted as an NDIS_RESOURCE_LISTstructure, which is equivalent to the CM_PARTIAL_RESOURCE_LISTstructure on Windows NT platforms.

The bus-relative configuration parameters returned in this buffer can be used in the MiniportInitializefunction's subsequent calls to Ndis XXXfunctions such as NdisMRegisterInterrupt, NdisMMapIoSpace, and/or NdisMRegisterIoPortRange.

A driver that calls this function runs at IRQL PASSIVE_LEVEL.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	2.0 and later	Ndis.h

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

Last updated on Tuesday, July 13, 2004