NdisMPciAssignResources

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

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

Parameters

MiniportHandle: Specifies the MiniportAdapterHandle passed in to MiniportInitialize and to most other MiniportXxx functions.
SlotNumber: Specifies the slot number of the driver’s NIC on the PCI bus.
AssignedResources: Points to a caller-supplied variable in which this function returns a pointer to a list of the hardware resources the NIC can use.

Return Value

NdisMPciAssignResources returns NDIS_STATUS_SUCCESS.

Comments

NdisMPciAssignResources claims a set of hardware resources in the registry for a miniport’s PCI NIC to use, thereby preventing conflicting claims on the same resources from other devices in the machine.

The buffer specified at AssignedResources is formatted as an NDIS_RESOURCE_LIST, which is equivalent to the CM_PARTIAL_RESOURCE_LIST on Windows NT platforms. See the Kernel-Mode Driver Reference for details of this structure.

The bus-relative configuration parameters returned in this buffer can be used in the MiniportInitialize function’s subsequent calls to NdisXxx functions such as NdisMRegisterInterrupt, NdisMMapIoSpace, and/or NdisMRegisterIoPortRange.

Callers of NdisMPciAssignResources run at IRQL PASSIVE_LEVEL.