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

See also

SerialDisplayAdvancedSettings

Send comments about this topic to Microsoft