Share via


PPORT_ADVANCED_DIALOG routine

A PPORT_ADVANCED_DIALOG-typed routine supplies an optional vendor-supplied dialog box that is called by the SerialDisplayAdvancedSettings routine.

Syntax

typedef BOOL (*PPORT_ADVANCED_DIALOG)(
  _In_     HWND             ParentHwnd,
  _In_     BOOL             HidePollingUI,
  _In_     HDEVINFO         DeviceInfoSet,
  _In_     PSP_DEVINFO_DATA DeviceInfoData,
  _In_opt_ PVOID            Reserved
);

Parameters

  • ParentHwnd [in]
    Handle to the parent window for the dialog box.

  • HidePollingUI [in]
    Specifies, if TRUE, to not show polling controls; otherwise, polling controls are shown.

  • DeviceInfoSet [in]
    Specifies the device information set that includes the device instance specified by DeviceInfoData.

  • DeviceInfoData [in]
    Pointer to the device instance in the specified device information set. The routine displays the advanced settings dialog box for this device.

  • Reserved [in, optional]
    Not used.

Return value

If the user presses OK in the dialog box, the routine returns TRUE. Otherwise, the routine returns FALSE.

Remarks

Use a PPORT_ADVANCED_DIALOG-typed routine to implement an optional dialog box that overrides the default dialog box displayed by SerialDisplayAdvancedSettings.

A PPORT_ADVANCED_DIALOG-typed routine runs in user mode.

For more information, see Installing an Advanced Properties Page for a COM Port.

Requirements

Target platform

Desktop

Header

Msports.h (include Msports.h)

See also

SerialDisplayAdvancedSettings

 

 

Send comments about this topic to Microsoft