REAL_TIME_NOTIFICATION_SETTING_INPUT structure (mstcpip.h)

The REAL_TIME_NOTIFICATION_SETTING_INPUT structure provides input settings to apply for the REAL_TIME_NOTIFICATION_CAPABILITY transport setting for a TCP socket that is used with ControlChannelTrigger to receive background network notifications in a Windows Store app.

Syntax

typedef struct _REAL_TIME_NOTIFICATION_SETTING_INPUT {
  TRANSPORT_SETTING_ID TransportSettingId;
  GUID                 BrokerEventGuid;
} REAL_TIME_NOTIFICATION_SETTING_INPUT, *PREAL_TIME_NOTIFICATION_SETTING_INPUT;

Members

TransportSettingId

The transport setting ID.

BrokerEventGuid

The realtime notification broker event GUID for this transport ID.

Remarks

The REAL_TIME_NOTIFICATION_SETTING_INPUT structure is supported on Windows 8, and Windows Server 2012, and later versions of the operating system.

If the TRANSPORT_SETTING_ID in the lpvInBuffer parameter passed to the SIO_APPLY_TRANSPORT_SETTING IOCTL has the Guid member set to REAL_TIME_NOTIFICATION_CAPABILITY, then this is a request to query the real time notification settings for the TCP socket used with ControlChannelTrigger to receive background network notifications in a Windows Store app. The lpvInBuffer parameter should point to a REAL_TIME_NOTIFICATION_SETTING_INPUT structure used as input to the SIO_APPLY_TRANSPORT_SETTING IOCTL to apply the transport setting.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Header mstcpip.h

See also

ControlChannelTrigger

REAL_TIME_NOTIFICATION_SETTING_OUTPUT

SIO_APPLY_TRANSPORT_SETTING

SIO_QUERY_TRANSPORT_SETTING

TRANSPORT_SETTING_ID