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