Share via

Av61883_GetUnitInfo control code

  • Article

The Av61883_GetUnitInfo request retrieves unit information about the device. The Plug and Play ID for a 61883 device is based on its VendorID, ModelID, and Character/Transaction Set. The relevant members of the AV_61883_REQUEST structure for this request are:

typedef struct _AV_61883_REQUEST {
  ULONG  Function;
  ULONG  Flags;
  union {
    typedef struct _GET_UNIT_INFO {
      IN ULONG  nLevel;
      IN OUT PVOID  Information;
    } GET_UNIT_INFO, *PGET_UNIT_INFO;
    .
    .
    .
  };
} AV_61883_REQUEST, *PAV_61883_REQUEST;

Input Buffer

AV_61883_REQUEST Input

  • Function
    Av61883_GetUnitInfo

  • Flags
    Specifies either RETRIEVE_DEVICE_UNIT_INFO or RETRIEVE_LOCAL_UNIT_INFO. Only used when nLevel is set to GET_UNIT_INFO_CAPABILITIES.

  • nLevel
    The level of information to retrieve. Can be one of the following:

    GET_UNIT_INFO_IDS

    GET_UNIT_INFO_CAPABILITIES

    GET_UNIT_INFO_ISOCH_PARAMS

    GET_UNIT_BUS_GENERATION_NODE

    GET_UNIT_DDI_VERSION

    GET_UNIT_DIAG_LEVEL

  • Information

    Value of nLevel Meaning

    GET_UNIT_INFO_IDS

    This member points to a caller-allocated and initialized GET_UNIT_IDS structure. The input GET_UNIT_IDS structure should be initialized to all zeros to obtain the length of the VendorText and ModelText strings. To obtain the strings themselves, the input ulVendorLength and ulModelLength members should be initialized to the values returned by the previous Av61883_GetUnitInfo call, and the input VendorText and ModelText members should point to buffers large enough to receive the strings.

    GET_UNIT_INFO_CAPABILITIES

    This member points to a caller-allocated GET_UNIT_CAPABILITIES structure.

    GET_UNIT_INFO_ISOCH_PARAMS

    This member points to a caller-allocated UNIT_ISOCH_PARAMS structure.

     

Output Buffer

AV_61883_REQUEST Output

  • Information
    Pointer to information supplied by the protocol driver about the device.

    Value of nLevel Action of the Protocol Driver

    GET_UNIT_INFO_IDS

    The protocol driver writes device ID information to the caller-allocated GET_UNIT_IDS structure at Information.

    GET_UNIT_INFO_CAPABILITIES

    The protocol driver writes a GET_UNIT_CAPABILITIES structure containing device capability information.

    GET_UNIT_ISOCH_PARAMS

    The protocol driver writes a UNIT_ISOCH_PARAMS structure containing device parameters used by the device to capture and transmit isochronous packets.

    GET_UNIT_BUS_GENERATION_NODE

    The protocol driver writes current bus characteristics to the caller-allocated BUS_GENERATION_NODE structure at Information.

    GET_UNIT_DDI_VERSION

    The protocol driver writes current 61883 DDI version to the caller-allocated UNIT_DDI_VERSION structure at Information.

    GET_UNIT_DIAG_LEVEL

    The protocol driver writes current diag level to the caller-allocated UNIT_DIAG_LEVEL structure at Information.

     

Status block

If successful, the IEC-61883 protocol driver sets Irp->IoStatus.Status to STATUS_SUCCESS.

If an incorrect parameter is passed in, the protocol driver sets Irp->IoStatus.Status to STATUS_INVALID_PARAMETER.

Requirements

Header

 61883.h (include 61883.h)

See also

AV_61883_REQUEST

UNIT_ISOCH_PARAMS

 

 

Send comments about this topic to Microsoft