OID_WW_GEN_CURRENT_ADDRESS
As a query, the OID_WW_GEN_CURRENT_ADDRESS OID requests the miniport driver to return the address in use by the NIC in the format specified. At initialization, the miniport driver sets the current address to the value returned for OID_WW_GEN_PERMANENT_ADDRESS.
As a set, this OID requests the miniport driver to change the current address.
The format of the current address depends on the header format, which must be one of the supported header formats listed with OID_WW_GEN_HEADER_FORMATS_SUPPORTED.
This request uses a WW_CURRENT_ADDRESS structure, defined as follows:
typedef struct _WW_CURRENT_ADDRESS {
NDIS_WW_HEADER_FORMAT Format;
NDIS_VAR_DATA_DESC Address;
} WW_CURRENT_ADDRESS;
The members of this structure contain the following information:
Format
Specifies one of the system-defined NdisWW..Frames values, listed with OID_WW_GEN_HEADER_FORMATS_SUPPORTED.If an incoming set request supplies anything other than an NdisWW..Frames value or if it supplies any value that the underlying driver does not support, the driver returns NDIS_STATUS_NOT_SUPPORTED.
Address
Describes a buffer containing the station address in use by the NIC. The miniport driver maps this value, which must be compatible with the value of Format, to the address of the NIC in its native format.The buffer contains a network-ordered sequence of binary byte values.If an incoming set request supplies an invalid address specification, the driver returns NDIS_STATUS_INVALID_DATA.
The current address is identical for all protocols bound to the same NIC miniport driver. A requested change affects all bound protocols.
If any bound protocol has enabled indications with OID_WW_GEN_INDICATION_REQUEST, the miniport driver must call NdisMIndicateStatus to notify such protocol(s) if the current address is changed. If the current address is unknown, the miniport driver should set the Lengthmember of the Address member of WW_CURRENT_ADDRESS to zero for the indication. It can ignore the TriggerValue member that was specified in the OID_WW_GEN_INDICATION_REQUEST.
Note This OID is not available for use beginning with Windows Vista.