NDIS_OPER_STATE structure (ntddndis.h)

Article
05/26/2021

The NDIS_OPER_STATE structure provides the current operational state of an NDIS network interface.

Syntax

typedef struct _NDIS_OPER_STATE {
  NDIS_OBJECT_HEADER Header;
  NET_IF_OPER_STATUS OperationalStatus;
  ULONG              OperationalStatusFlags;
} NDIS_OPER_STATE, *PNDIS_OPER_STATE;

Members

Header

The NDIS_OBJECT_HEADER structure for the NDIS_OPER_STATE structure. Set the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_DEFAULT, the Revision member to NDIS_OPER_STATE_REVISION_1, and the Size member to NDIS_SIZEOF_OPER_STATE_REVISION_1.

OperationalStatus

The NET_IF_OPER_STATUS operational status type.

OperationalStatusFlags

This member provides the reason why the OperationalStatus member is set to NET_IF_OPER_STATUS_DOWN or NET_IF_OPER_STATUS_DORMANT. This member is a ULONG value that contains a bitwise OR of a combination of the following flags:

NET_IF_OPER_STATUS_DOWN_NOT_AUTHENTICATED

The operational status is set to NET_IF_OPER_STATUS_DOWN because the default port of the miniport adapter is not authenticated.

NET_IF_OPER_STATUS_DOWN_NOT_MEDIA_CONNECTED

The operational status is set to NET_IF_OPER_STATUS_DOWN because the miniport adapter is not in a media-connected state.

NET_IF_OPER_STATUS_DORMANT_PAUSED

The operational status is set to NET_IF_OPER_STATUS_DORMANT because the miniport adapter is in the paused or pausing state.

NET_IF_OPER_STATUS_DORMANT_LOW_POWER

The operational status is set to NET_IF_OPER_STATUS_DORMANT because the miniport adapter is in a low power state.

Remarks

For the NDIS_STATUS_OPER_STATUS status indication, NDIS supplies an NDIS_OPER_STATE structure in the StatusBuffer member of the NDIS_STATUS_INDICATION structure.

NDIS_STATUS_OPER_STATUS indicates the current operational state of an NDIS network interface to overlying drivers.

Requirements

Requirement	Value
Minimum supported client	Supported in NDIS 6.0 and later.
Header	ntddndis.h (include Ndis.h)