OID_WW_GEN_PING_ADDRESS

  • 아티클

As a set, the OID_WW_GEN_PING_ADDRESS OID requests an underlying miniport driver and its NIC to transmit a diagnostic packet for an echo-request operation to the specified node through the currently connected wireless network. The only intent of this OID is to allow protocols and applications to determine if two-way communications can be established to a remote node on the currently attached network. On some networks, additional functionality may be provided to detect if full end-to-end connectivity can be established. This OID is defined as OPTIONAL.

As a query, this OID requests the underlying miniport driver and its NIC to return information about the results of a previous echo-request operation to determine if a remote node was connected to a wireless network.

This request uses a WW_PING_ADDRESS structure, defined as follows:

typedef struct _WW_PING_ADDRESS {    
IN        WW_ADDRESS_FORMAT Format;
    
IN        NDIS_VAR_DATA_DESC TargetAddress;
    
OUT        UINT uTime;
 } WW_PING_ADDRESS;

The members of this structure contain the following information:

  • Format
    Address format of the remote node specified by TargetAddress. This address format must be one of the values contained in the WW_ADDRESS_FORMAT enumeration. The following lists the valid values.

    • WW_IEEE_ADDRESS
      A 48-bit IEEE address in network byte order.

    • WW_MOBITEX_MAN_ADDRESS
      A Mobitex access number in network byte order.

    • WW_DATATAC_RDLAP_ADDRESS
      A DataTAC RDLAP address in network byte order.

    • WW_DATATAC_MDC4800_ADDRESS
      A DataTAC MDC 4800 address in network byte order.

    • WW_DATATAC_RESERVED
      Reserved by DataTAC networks.

    • WW_IPv4_ADDRESS
      An IP version 4 address in network byte order.

    • WW_IPv6_ADDRESS
      An IP version 6 address in network byte order.

    • WW_PROPRIETARY_ADDRESS
      Address is specified in a proprietary format. The miniport driver must decode the format in which the address is represented.

    If an incoming echo-request operation supplies anything other than one of the preceding values or if it supplies a value that the underlying driver does not support, the underlying driver returns NDIS_STATUS_NOT_SUPPORTED.

  • TargetAddress
    Specifies a NDIS_VAR_DATA_DESC type that describes a buffer containing the station network address in use by the remote node. The miniport driver maps this address, which must be compatible with the value of Format, to a native address of the currently connected wireless network. The address in the buffer is represented in network byte order.

    Broadcast or group addresses are invalid for this operation and the miniport driver should return NDIS_STATUS_INVALID_DATA.

  • uTime
    Specifies the length of time in milliseconds for the echo-request operation to complete. This operation requires the miniport driver to transmit a diagnostic packet to the remote node and then receive a response from the remote node. This member specifies the time that elapses between the transmission and response. A value of -1 represents an unsuccessful echo-request operation.

Indications are irrelevant for this OID.

Note   This OID is not available for use beginning with Windows Vista.

 

 

 

Send comments about this topic to Microsoft