 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 writes a specified number of bytes to the PCI configuration space for an NIC on the PCI bus.
ULONG NdisWritePciSlotInformation( IN NDIS_HANDLE NdisAdapterHandle , IN ULONG SlotNumber , IN ULONG Offset , IN PVOID Buffer , IN ULONG Length );
Parameters
- NdisAdapterHandle
- Specifies the MiniportAdapterHandlepassed in to the MiniportInitializefunction and to most other Miniport XXXfunctions.
- SlotNumber
- Specifies the slot number of the NIC on the I/O bus.
- Offset
- Specifies the byte offset within the PCI configuration space at which to begin transferring the caller-supplied configuration information.
- Buffer
- Pointer to a caller-allocated buffer containing the PCI configuration information to be written.
- Length
- Specifies the size, in bytes, of the buffer at
Bufferand, therefore, how many bytes of PCI configuration
information to write.
Return Values
Returns how many bytes of caller-supplied data it wrote.
Remarks
This function writes PCI configuration information for an NIC. However, drivers of NICs on PCI buses call the NdisImmediateReadPciSlotInformation, NdisReadPciSlotInformation, or NdisMPciAssignResourcesfunction far more frequently than this function.
When an NIC driver finds its device on a PCI bus with the Ndis(Immediate)ReadPciSlotInformationfunction or by retrieving information from the \ DriverName\Parameterskey in the registry, that driver can call NdisMPciAssignResourcesto determine the bus-relative configuration parameters to use in subsequent calls to other NDIS configuration functions. If NdisMPciAssignResourcesreturns values that require the driver to reconfigure its device on the bus, it can call this function.
This function transfers the same type of bus-relative PCI configuration information as the NdisImmediateWritePciSlotInformationfunction. However, callers of this function pass the MiniportAdapterHandlepassed in to the MiniportInitializefunction, rather than the WrapperConfigurationContexthandle.
The caller is responsible for releasing the memory at Bufferwhen this function returns control.
A driver that calls this function can run at IRQL <= DISPATCH_LEVEL. Usually, callers are running 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.
See Also
NdisFreeMemory, NdisMMapIoSpace, NdisMPciAssignResources, NdisMRegisterInterrupt, NdisMRegisterIoPortRange, NdisMSetAttributes, NdisMSetAttributesEx, NdisReadPciSlotInformation
Last updated on Tuesday, July 13, 2004