Share via

NdisMPciAssignResources (Compact 2013)

  • Article

3/26/2014

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.

Syntax

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

Parameters

  • MiniportHandle
    [in] Specifies the MiniportAdapterHandle passed in to the MiniportInitialize function and to most other MiniportXXX functions.
  • SlotNumber
    [in] Specifies the slot number of the driver's NIC on the PCI bus.
  • AssignedResources
    [out] Pointer to a list of the hardware resources that the NIC can use.

Return Value

Returns NDIS_STATUS_SUCCESS.

Remarks

Note

This function is obsolete in NDIS 5.1 and should not be used by a miniport driver. The NdisMQueryAdapterResources function should be used in place of NdisMPciAssignResources.

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 AssignedResources is formatted as an NDIS_RESOURCE_LIST structure, which is equivalent to the CM_PARTIAL_RESOURCE_LIST structure on Microsoft® Windows NT®-based platforms.

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.

Requirements

Header

ndis.h

Library

ndis.dll

See Also

Reference

NDIS 5.x Legacy Functions
MiniportInitialize
NdisMMapIoSpace
NdisReadPciSlotInformation
NdisMRegisterInterrupt
NdisMRegisterIoPortRange