NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES (Compact 2013)

發行項
07/31/2017

3/26/2014

An NDIS miniport driver sets up an NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES structure to define registration attributes for a miniport adapter.

Syntax

typedef struct _NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES
{
  NDIS_OBJECT_HEADER  Header;
  NDIS_HANDLE  MiniportAdapterContext;
  ULONG  AttributeFlags;
  UINT  CheckForHangTimeInSeconds;
  NDIS_INTERFACE_TYPE  InterfaceType;
} NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES, *PNDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES;

Members

Header
The NDIS_OBJECT_HEADER structure for the NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES structure. Set the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES, the Revision member to NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES_REVISION_1, and the Size member to NDIS_SIZEOF_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES_REVISION_1.

MiniportAdapterContext
A handle to a context area that the miniport driver allocated in its MiniportInitializeEx function. The miniport driver uses this context area to maintain state information for a miniport adapter.

AttributeFlags
A bitmask of flags that are combined with a bitwise OR. Network Driver Interface Specification (NDIS) 6.0 drivers set one or more of the following flags:
- NDIS_MINIPORT_ATTRIBUTES_HARDWARE_DEVICE
  Set if the miniport driver directly controls a physical device. Physical devices are those that are assigned hardware resources such as interrupts, I/O ports, memory-mapped I/O, or Direct Memory Access (DMA) channels that the miniport driver receives from the MiniportInitializeEx function.
- NDIS_MINIPORT_ATTRIBUTES_NDIS_WDM
  Set if the lower-level interface of the miniport adapter is a Windows Driver Model (WDM) bus driver such as USB or IEEE 1394. If this member is set, the miniport driver does not allocate hardware resources such as I/O ports, interrupts, memory-mapped I/O, or DMA channels. Instead, the driver communicates with the device through the underlying bus driver's WDM interface.
- NDIS_MINIPORT_ATTRIBUTES_BUS_MASTER
  Set if the caller's network adapter is a bus-master DMA device.
- NDIS_MINIPORT_ATTRIBUTES_NO_HALT_ON_SUSPEND
  Set to prevent NDIS from calling a driver's MiniportHaltEx function before the system transitions to a low-power (sleeping) state. Drivers that rely on a hardware-maintained state must not set this flag.
- NDIS_MINIPORT_ATTRIBUTES_SURPRISE_REMOVE_OK
  Set if the driver can remove its network adapter without notifying the user. NDIS drivers receive surprise removal notifications from the MiniportDevicePnPEventNotify function of the miniport driver.
- NDIS_MINIPORT_ATTRIBUTES_NOT_CO_NDIS
  Set by a driver that supports both connection-oriented and connectionless devices to indicate that the device is a connectionless device.
- NDIS_MINIPORT_ATTRIBUTES_DO_NOT_BIND_TO_ALL_CO
  Set by a CoNDIS miniport driver that does not provide TAPI services. Setting NDIS_MINIPORT_ATTRIBUTES_DO_NOT_BIND_TO_ALL_CO prevents NDIS from binding the miniport driver to the NDIS TAPI proxy driver (NDPROXY). By default, NDIS binds NDPROXY to all CoNDIS miniport drivers.
- NDIS_MINIPORT_ATTRIBUTES_CONTROLS_DEFAULT_PORT
  Set by a driver that calls the NdisMNetPnPEvent function to activate its default port. If NDIS_MINIPORT_ATTRIBUTES_CONTROLS_DEFAULT_PORT is not set, the default port is active. NDIS does not bind protocol drivers or attach filter modules to a miniport adapter if its default port is not active.

CheckForHangTimeInSeconds
The interval, in seconds, at which NDIS calls the MiniportCheckForHangEx function. If a driver has not responded to an object identifier request or send request within two successive calls to MiniportCheckForHangEx, NDIS calls the driver's MiniportResetEx function.

The interval that NDIS uses when it calls MiniportCheckForHangEx is always a multiple of two seconds. For example, if you specify five seconds the actual interval will be approximately four seconds.

Specifying 0 (zero) for this member indicates that NDIS calls MiniportCheckForHangEx at the NDIS default two-second interval.

InterfaceType
The I/O bus interface type of the miniport adapter. The interface type is usually the type of I/O bus to which the miniport adapter is connected. The following values are supported in NDIS 6.0:
- NdisInterfaceInternal
  Specifies a host-specific internal interface.
- NdisInterfaceIsa
  Specifies the Industry Standard Architecture (ISA) interface.
- NdisInterfaceEisa
  Specifies the extended ISA (EISA) interface. This interface type is not supported in NDIS 6.0 through NDIS 6.2.
- NdisInterfaceMca
  Refers to the MCA bus, which is no longer supported. This interface type is not supported in NDIS 6.0 through NDIS 6.2.
- NdisInterfaceTurboChannel
  Specifies the Turbo Channel interface.
- NdisInterfacePci
  Specifies the Peripheral Component Interconnect (PCI) interface.
- NdisInterfaceCBus
  Specifies the CBus.
- NdisInterfaceMPIBus
  Specifies the MPIBus.
- NdisInterfaceMPSABus
  Specifies the MPSABus.
- NdisInterfaceProcessorInternal
  Specifies the processor internal bus.
- NdisInterfaceInternalPowerBus
  Specifies the internal power bus.
- NdisInterfacePNPISABus
  Specifies the PNPISABus.
- NdisInterfacePNPBus
  Specifies the PNPBus.
This parameter is irrelevant for intermediate drivers, which should specify 0 (zero) for this member.

Remarks

A miniport driver passes a pointer to an NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES structure in the MiniportAttributes parameter of the NdisMSetMiniportAttributes function. A miniport driver calls NdisMSetMiniportAttributes from its MiniportInitializeEx function during initialization.

Miniport drivers must set the attributes in NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES as soon as possible in MiniportInitializeEx. Setting these attributes is mandatory.

Requirements

Header

ndis.h

共用方式為

NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES (Compact 2013)

Syntax

Members

Remarks

Requirements

See Also

Reference

其他資源