Package org.lwjgl.openxr

Class METAColocationDiscovery

java.lang.Object

org.lwjgl.openxr.METAColocationDiscovery

public class METAColocationDiscovery
extends Object

The XR_META_colocation_discovery extension.

Colocation discovery is a capability available through the XR_META_colocation_discovery extension that allows apps to discover physically colocated devices running the same app.

In the context of this extension, "the same application" means "bytewise identical Android package name" when running on an Android-based platform.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	XR_COLOCATION_DISCOVERY_ALREADY_ADVERTISING_META	Extends XrResult.
static final int	XR_COLOCATION_DISCOVERY_ALREADY_DISCOVERING_META	Extends XrResult.
static final int	XR_ERROR_COLOCATION_DISCOVERY_NETWORK_FAILED_META	Extends XrResult.
static final int	XR_ERROR_COLOCATION_DISCOVERY_NO_DISCOVERY_METHOD_META	Extends XrResult.
static final int	XR_MAX_COLOCATION_DISCOVERY_BUFFER_SIZE_META	XR_MAX_COLOCATION_DISCOVERY_BUFFER_SIZE_META
static final String	XR_META_COLOCATION_DISCOVERY_EXTENSION_NAME	The extension name.
static final int	XR_META_colocation_discovery_SPEC_VERSION	The extension specification version.
static final int	XR_TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META	Extends XrStructureType.
static final int	XR_TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META	Extends XrStructureType.
static final int	XR_TYPE_COLOCATION_DISCOVERY_START_INFO_META	Extends XrStructureType.
static final int	XR_TYPE_COLOCATION_DISCOVERY_STOP_INFO_META	Extends XrStructureType.
static final int	XR_TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META	Extends XrStructureType.
static final int	XR_TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META	Extends XrStructureType.
static final int	XR_TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META	Extends XrStructureType.
static final int	XR_TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META	Extends XrStructureType.
static final int	XR_TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META	Extends XrStructureType.
static final int	XR_TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META	Extends XrStructureType.
static final int	XR_TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META	Extends XrStructureType.
static final int	XR_TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META	Extends XrStructureType.

Method Summary

Modifier and Type	Method	Description
static int	nxrStartColocationAdvertisementMETA(XrSession session, long info, long advertisementRequestId)	Unsafe version of: StartColocationAdvertisementMETA
static int	nxrStartColocationDiscoveryMETA(XrSession session, long info, long discoveryRequestId)	Unsafe version of: StartColocationDiscoveryMETA
static int	nxrStopColocationAdvertisementMETA(XrSession session, long info, long requestId)	Unsafe version of: StopColocationAdvertisementMETA
static int	nxrStopColocationDiscoveryMETA(XrSession session, long info, long requestId)	Unsafe version of: StopColocationDiscoveryMETA
static int	xrStartColocationAdvertisementMETA(XrSession session, XrColocationAdvertisementStartInfoMETA info, LongBuffer advertisementRequestId)	Start colocation visibility.
static int	xrStartColocationDiscoveryMETA(XrSession session, XrColocationDiscoveryStartInfoMETA info, LongBuffer discoveryRequestId)	Start colocation discovery.
static int	xrStopColocationAdvertisementMETA(XrSession session, XrColocationAdvertisementStopInfoMETA info, LongBuffer requestId)	Stop colocation advertisement.
static int	xrStopColocationDiscoveryMETA(XrSession session, XrColocationDiscoveryStopInfoMETA info, LongBuffer requestId)	Stop ongoing discovery process.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

XR_META_colocation_discovery_SPEC_VERSION

public static final int XR_META_colocation_discovery_SPEC_VERSION

The extension specification version.

See Also:

• Constant Field Values

XR_META_COLOCATION_DISCOVERY_EXTENSION_NAME

public static final String XR_META_COLOCATION_DISCOVERY_EXTENSION_NAME

The extension name.

See Also:

• Constant Field Values

XR_MAX_COLOCATION_DISCOVERY_BUFFER_SIZE_META

public static final int XR_MAX_COLOCATION_DISCOVERY_BUFFER_SIZE_META

XR_MAX_COLOCATION_DISCOVERY_BUFFER_SIZE_META

See Also:

• Constant Field Values

XR_ERROR_COLOCATION_DISCOVERY_NETWORK_FAILED_META

public static final int XR_ERROR_COLOCATION_DISCOVERY_NETWORK_FAILED_META

Extends XrResult.

Enum values:

• ERROR_COLOCATION_DISCOVERY_NETWORK_FAILED_META
• ERROR_COLOCATION_DISCOVERY_NO_DISCOVERY_METHOD_META
• COLOCATION_DISCOVERY_ALREADY_ADVERTISING_META
• COLOCATION_DISCOVERY_ALREADY_DISCOVERING_META

See Also:

• Constant Field Values

XR_ERROR_COLOCATION_DISCOVERY_NO_DISCOVERY_METHOD_META

public static final int XR_ERROR_COLOCATION_DISCOVERY_NO_DISCOVERY_METHOD_META

Extends XrResult.

Enum values:

• ERROR_COLOCATION_DISCOVERY_NETWORK_FAILED_META
• ERROR_COLOCATION_DISCOVERY_NO_DISCOVERY_METHOD_META
• COLOCATION_DISCOVERY_ALREADY_ADVERTISING_META
• COLOCATION_DISCOVERY_ALREADY_DISCOVERING_META

See Also:

• Constant Field Values

XR_COLOCATION_DISCOVERY_ALREADY_ADVERTISING_META

public static final int XR_COLOCATION_DISCOVERY_ALREADY_ADVERTISING_META

Extends XrResult.

Enum values:

• ERROR_COLOCATION_DISCOVERY_NETWORK_FAILED_META
• ERROR_COLOCATION_DISCOVERY_NO_DISCOVERY_METHOD_META
• COLOCATION_DISCOVERY_ALREADY_ADVERTISING_META
• COLOCATION_DISCOVERY_ALREADY_DISCOVERING_META

See Also:

• Constant Field Values

XR_COLOCATION_DISCOVERY_ALREADY_DISCOVERING_META

public static final int XR_COLOCATION_DISCOVERY_ALREADY_DISCOVERING_META

Extends XrResult.

Enum values:

• ERROR_COLOCATION_DISCOVERY_NETWORK_FAILED_META
• ERROR_COLOCATION_DISCOVERY_NO_DISCOVERY_METHOD_META
• COLOCATION_DISCOVERY_ALREADY_ADVERTISING_META
• COLOCATION_DISCOVERY_ALREADY_DISCOVERING_META

See Also:

• Constant Field Values

XR_TYPE_COLOCATION_DISCOVERY_START_INFO_META

public static final int XR_TYPE_COLOCATION_DISCOVERY_START_INFO_META

Extends XrStructureType.

Enum values:

• TYPE_COLOCATION_DISCOVERY_START_INFO_META
• TYPE_COLOCATION_DISCOVERY_STOP_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META
• TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META

See Also:

• Constant Field Values

XR_TYPE_COLOCATION_DISCOVERY_STOP_INFO_META

public static final int XR_TYPE_COLOCATION_DISCOVERY_STOP_INFO_META

Extends XrStructureType.

Enum values:

• TYPE_COLOCATION_DISCOVERY_START_INFO_META
• TYPE_COLOCATION_DISCOVERY_STOP_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META
• TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META

See Also:

• Constant Field Values

XR_TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META

public static final int XR_TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META

Extends XrStructureType.

Enum values:

• TYPE_COLOCATION_DISCOVERY_START_INFO_META
• TYPE_COLOCATION_DISCOVERY_STOP_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META
• TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META

See Also:

• Constant Field Values

XR_TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META

public static final int XR_TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META

Extends XrStructureType.

Enum values:

• TYPE_COLOCATION_DISCOVERY_START_INFO_META
• TYPE_COLOCATION_DISCOVERY_STOP_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META
• TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META

See Also:

• Constant Field Values

XR_TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META

public static final int XR_TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META

Extends XrStructureType.

Enum values:

• TYPE_COLOCATION_DISCOVERY_START_INFO_META
• TYPE_COLOCATION_DISCOVERY_STOP_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META
• TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META

See Also:

• Constant Field Values

XR_TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META

public static final int XR_TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META

Extends XrStructureType.

Enum values:

• TYPE_COLOCATION_DISCOVERY_START_INFO_META
• TYPE_COLOCATION_DISCOVERY_STOP_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META
• TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META

See Also:

• Constant Field Values

XR_TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META

public static final int XR_TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META

Extends XrStructureType.

Enum values:

• TYPE_COLOCATION_DISCOVERY_START_INFO_META
• TYPE_COLOCATION_DISCOVERY_STOP_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META
• TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META

See Also:

• Constant Field Values

XR_TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META

public static final int XR_TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META

Extends XrStructureType.

Enum values:

• TYPE_COLOCATION_DISCOVERY_START_INFO_META
• TYPE_COLOCATION_DISCOVERY_STOP_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META
• TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META

See Also:

• Constant Field Values

XR_TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META

public static final int XR_TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META

Extends XrStructureType.

Enum values:

• TYPE_COLOCATION_DISCOVERY_START_INFO_META
• TYPE_COLOCATION_DISCOVERY_STOP_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META
• TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META

See Also:

• Constant Field Values

XR_TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META

public static final int XR_TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META

Extends XrStructureType.

Enum values:

• TYPE_COLOCATION_DISCOVERY_START_INFO_META
• TYPE_COLOCATION_DISCOVERY_STOP_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META
• TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META

See Also:

• Constant Field Values

XR_TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META

public static final int XR_TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META

Extends XrStructureType.

Enum values:

• TYPE_COLOCATION_DISCOVERY_START_INFO_META
• TYPE_COLOCATION_DISCOVERY_STOP_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META
• TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META

See Also:

• Constant Field Values

XR_TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META

public static final int XR_TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META

Extends XrStructureType.

Enum values:

• TYPE_COLOCATION_DISCOVERY_START_INFO_META
• TYPE_COLOCATION_DISCOVERY_STOP_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_START_INFO_META
• TYPE_COLOCATION_ADVERTISEMENT_STOP_INFO_META
• TYPE_EVENT_DATA_START_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_ADVERTISEMENT_COMPLETE_META
• TYPE_EVENT_DATA_START_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_RESULT_META
• TYPE_EVENT_DATA_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_EVENT_DATA_STOP_COLOCATION_DISCOVERY_COMPLETE_META
• TYPE_SYSTEM_COLOCATION_DISCOVERY_PROPERTIES_META

See Also:

• Constant Field Values

Method Details

nxrStartColocationDiscoveryMETA

public static int nxrStartColocationDiscoveryMETA(XrSession session,
 long info,
 long discoveryRequestId)

Unsafe version of: StartColocationDiscoveryMETA

xrStartColocationDiscoveryMETA

public static int xrStartColocationDiscoveryMETA(XrSession session,
 XrColocationDiscoveryStartInfoMETA info,
 LongBuffer discoveryRequestId)

Start colocation discovery.

C Specification

The StartColocationDiscoveryMETA function is defined as:

 XrResult xrStartColocationDiscoveryMETA(
     XrSession                                   session,
     const XrColocationDiscoveryStartInfoMETA*   info,
     XrAsyncRequestIdFB*                         discoveryRequestId);

Description

The application can call StartColocationDiscoveryMETA to start discovering physically colocated devices.

If the system does not support colocation advertisement and discovery, the runtime must return ERROR_FEATURE_UNSUPPORTED from StartColocationDiscoveryMETA. In this case, the runtime must return FALSE for XrSystemColocationDiscoveryPropertiesMETA::supportsColocationDiscovery when the function GetSystemProperties is called, so that the application knows to not use this functionality.

This is an asynchronous operation. Completion results are conveyed in the event XrEventDataStartColocationDiscoveryCompleteMETA.

If the asynchronous operation is scheduled successfully, the runtime must return SUCCESS.

If and only if the runtime returns SUCCESS, the runtime must queue a single XrEventDataStartColocationDiscoveryCompleteMETA event identified with a discoveryRequestId matching the discoveryRequestId value output by this function, referred to as the "corresponding completion event."

(This implies that if the runtime returns anything other than SUCCESS, the runtime must not queue any XrEventDataStartColocationDiscoveryCompleteMETA events with discoveryRequestId field matching the discoveryRequestId populated by this function.)

If the asynchronous operation is successful, in the corresponding completion event, the runtime must set the XrEventDataStartColocationDiscoveryCompleteMETA::result field to SUCCESS. The runtime may subsequently queue zero or more XrEventDataColocationDiscoveryResultMETA events asynchronously as the runtime discovers nearby advertisements. Once the application or runtime stops the colocation discovery, the runtime must queue a single XrEventDataColocationDiscoveryCompleteMETA event. All XrEventDataColocationDiscoveryResultMETA and XrEventDataColocationDiscoveryCompleteMETA events will identified with discoveryRequestId matching the value populated in discoveryRequestId by StartColocationDiscoveryMETA.

If the asynchronous operation is scheduled but not successful, in the corresponding completion event, the runtime must set the XrEventDataStartColocationDiscoveryCompleteMETA::result field to an appropriate error code instead of SUCCESS.

If the application already has an active colocation discovery, in the corresponding completion event, the runtime must set the XrEventDataStartColocationDiscoveryCompleteMETA::result field to COLOCATION_DISCOVERY_ALREADY_DISCOVERING_META.

Valid Usage (Implicit)

• The XR_META_colocation_discovery extension must be enabled prior to calling StartColocationDiscoveryMETA
• session must be a valid XrSession handle
• info must be a pointer to a valid XrColocationDiscoveryStartInfoMETA structure
• discoveryRequestId must be a pointer to an XrAsyncRequestIdFB value

Return Codes

On success, this command returns

• SUCCESS
• SESSION_LOSS_PENDING

On failure, this command returns

• ERROR_FUNCTION_UNSUPPORTED
• ERROR_VALIDATION_FAILURE
• ERROR_RUNTIME_FAILURE
• ERROR_HANDLE_INVALID
• ERROR_INSTANCE_LOST
• ERROR_SESSION_LOST
• ERROR_RUNTIME_UNAVAILABLE
• ERROR_FEATURE_UNSUPPORTED
• ERROR_EXTENSION_NOT_PRESENT

See Also

XrColocationDiscoveryStartInfoMETA, XrEventDataStartColocationDiscoveryCompleteMETA

Parameters:

session - an XrSession in which the colocation discovery will be active.

info - a pointer to XrColocationDiscoveryStartInfoMETA structure to specify the discovery request information.

discoveryRequestId - an output parameter, and the variable it points to will be populated with the ID of this asynchronous request. Note that this ID is used for associating additional events with this original call, in addition to the typical completion event.

nxrStopColocationDiscoveryMETA

public static int nxrStopColocationDiscoveryMETA(XrSession session,
 long info,
 long requestId)

Unsafe version of: StopColocationDiscoveryMETA

xrStopColocationDiscoveryMETA

public static int xrStopColocationDiscoveryMETA(XrSession session,
 XrColocationDiscoveryStopInfoMETA info,
 LongBuffer requestId)

Stop ongoing discovery process.

C Specification

The StopColocationDiscoveryMETA function is defined as:

 XrResult xrStopColocationDiscoveryMETA(
     XrSession                                   session,
     const XrColocationDiscoveryStopInfoMETA*    info,
     XrAsyncRequestIdFB*                         requestId);

Description

The application can call StopColocationDiscoveryMETA to stop an ongoing discovery process that was started by StartColocationDiscoveryMETA.

If the system does not support colocation advertisement and discovery, the runtime must return ERROR_FEATURE_UNSUPPORTED from StopColocationDiscoveryMETA. In this case, the runtime must return FALSE for XrSystemColocationDiscoveryPropertiesMETA::supportsColocationDiscovery when the function GetSystemProperties is called, so that the application knows to not use this functionality.

This is an asynchronous operation. Completion results are conveyed in the event XrEventDataStopColocationDiscoveryCompleteMETA.

If the asynchronous operation is scheduled successfully, the runtime must return SUCCESS.

If and only if the runtime returns SUCCESS, the runtime must queue a single XrEventDataStopColocationDiscoveryCompleteMETA event identified with a requestId matching the requestId value output by this function, referred to as the "corresponding completion event."

(This implies that if the runtime returns anything other than SUCCESS, the runtime must not queue any XrEventDataStopColocationDiscoveryCompleteMETA events with requestId field matching the requestId populated by this function.)

If the asynchronous operation is successful, in the corresponding completion event, the runtime must set the XrEventDataStopColocationDiscoveryCompleteMETA::result field to SUCCESS.

If the asynchronous operation is scheduled but not successful, in the corresponding completion event, the runtime must set the XrEventDataStopColocationDiscoveryCompleteMETA::result field to an appropriate error code instead of SUCCESS.

Valid Usage (Implicit)

• The XR_META_colocation_discovery extension must be enabled prior to calling StopColocationDiscoveryMETA
• session must be a valid XrSession handle
• info must be a pointer to a valid XrColocationDiscoveryStopInfoMETA structure
• requestId must be a pointer to an XrAsyncRequestIdFB value

Return Codes

On success, this command returns

• SUCCESS
• SESSION_LOSS_PENDING

On failure, this command returns

• ERROR_FUNCTION_UNSUPPORTED
• ERROR_VALIDATION_FAILURE
• ERROR_RUNTIME_FAILURE
• ERROR_HANDLE_INVALID
• ERROR_INSTANCE_LOST
• ERROR_SESSION_LOST
• ERROR_RUNTIME_UNAVAILABLE
• ERROR_FEATURE_UNSUPPORTED
• ERROR_EXTENSION_NOT_PRESENT

See Also

XrColocationDiscoveryStopInfoMETA, StartColocationDiscoveryMETA

Parameters:

session - an XrSession in which the colocation discovery will be active.

info - a pointer to XrColocationDiscoveryStopInfoMETA structure to specify the stop discovery request information.

requestId - an output parameter, and the variable it points to will be populated with the ID of this asynchronous request.

nxrStartColocationAdvertisementMETA

public static int nxrStartColocationAdvertisementMETA(XrSession session,
 long info,
 long advertisementRequestId)

Unsafe version of: StartColocationAdvertisementMETA

xrStartColocationAdvertisementMETA

public static int xrStartColocationAdvertisementMETA(XrSession session,
 XrColocationAdvertisementStartInfoMETA info,
 LongBuffer advertisementRequestId)

Start colocation visibility.

C Specification

The StartColocationAdvertisementMETA function is defined as:

 XrResult xrStartColocationAdvertisementMETA(
     XrSession                                   session,
     const XrColocationAdvertisementStartInfoMETA* info,
     XrAsyncRequestIdFB*                         advertisementRequestId);

Description

The StartColocationAdvertisementMETA function requests that the current device become discoverable by other physically colocated devices running the same application.

If the system does not support colocation advertisement and discovery, the runtime must return ERROR_FEATURE_UNSUPPORTED from StartColocationAdvertisementMETA. In this case, the runtime must return FALSE for XrSystemColocationDiscoveryPropertiesMETA::supportsColocationDiscovery when the function GetSystemProperties is called, so that the application knows to not use this functionality.

This is an asynchronous operation. Completion results are conveyed in the event XrEventDataStartColocationAdvertisementCompleteMETA.

If the asynchronous operation is scheduled successfully, the runtime must return SUCCESS.

If and only if the runtime returns SUCCESS, the runtime must queue a single XrEventDataStartColocationAdvertisementCompleteMETA event identified with a advertisementRequestId matching the advertisementRequestId value output by this function, referred to as the "corresponding completion event."

(This implies that if the runtime returns anything other than SUCCESS, the runtime must not queue any XrEventDataStartColocationAdvertisementCompleteMETA events with advertisementRequestId field matching the advertisementRequestId populated by this function.)

If the asynchronous operation is successful, in the corresponding completion event, the runtime must set the XrEventDataStartColocationAdvertisementCompleteMETA::result field to SUCCESS.

If the asynchronous operation is scheduled but not successful, in the corresponding completion event, the runtime must set the XrEventDataStartColocationAdvertisementCompleteMETA::result field to an appropriate error code instead of SUCCESS.

Valid Usage (Implicit)

• The XR_META_colocation_discovery extension must be enabled prior to calling StartColocationAdvertisementMETA
• session must be a valid XrSession handle
• info must be a pointer to a valid XrColocationAdvertisementStartInfoMETA structure
• advertisementRequestId must be a pointer to an XrAsyncRequestIdFB value

Return Codes

On success, this command returns

• SUCCESS
• SESSION_LOSS_PENDING

On failure, this command returns

• ERROR_FUNCTION_UNSUPPORTED
• ERROR_VALIDATION_FAILURE
• ERROR_RUNTIME_FAILURE
• ERROR_HANDLE_INVALID
• ERROR_INSTANCE_LOST
• ERROR_SESSION_LOST
• ERROR_RUNTIME_UNAVAILABLE
• ERROR_FEATURE_UNSUPPORTED
• ERROR_EXTENSION_NOT_PRESENT

See Also

XrColocationAdvertisementStartInfoMETA, XrEventDataStartColocationAdvertisementCompleteMETA

Parameters:

session - an XrSession in which the colocation discovery will be active.

info - a pointer to XrColocationAdvertisementStartInfoMETA structure to specify the visibility configuration.

advertisementRequestId - an output parameter, and the variable it points to will be populated with the ID of this asynchronous request. Note that this ID is used for associating additional events with this original call, in addition to the typical completion event.

nxrStopColocationAdvertisementMETA

public static int nxrStopColocationAdvertisementMETA(XrSession session,
 long info,
 long requestId)

Unsafe version of: StopColocationAdvertisementMETA

xrStopColocationAdvertisementMETA

public static int xrStopColocationAdvertisementMETA(XrSession session,
 XrColocationAdvertisementStopInfoMETA info,
 LongBuffer requestId)

Stop colocation advertisement.

C Specification

The StopColocationAdvertisementMETA function is defined as:

 XrResult xrStopColocationAdvertisementMETA(
     XrSession                                   session,
     const XrColocationAdvertisementStopInfoMETA* info,
     XrAsyncRequestIdFB*                         requestId);

Description

The application can use the StopColocationAdvertisementMETA function to disable the ability for other physically colocated devices running the same application to discover the current device.

If the system does not support colocation advertisement and discovery, the runtime must return ERROR_FEATURE_UNSUPPORTED from StopColocationAdvertisementMETA. In this case, the runtime must return FALSE for XrSystemColocationDiscoveryPropertiesMETA::supportsColocationDiscovery when the function GetSystemProperties is called, so that the application knows to not use this functionality.

This is an asynchronous operation. Completion results are conveyed in the event XrEventDataStopColocationAdvertisementCompleteMETA.

If the asynchronous operation is scheduled successfully, the runtime must return SUCCESS.

If and only if the runtime returns SUCCESS, the runtime must queue a single XrEventDataStopColocationAdvertisementCompleteMETA event identified with a requestId matching the requestId value output by this function, referred to as the "corresponding completion event."

(This implies that if the runtime returns anything other than SUCCESS, the runtime must not queue any XrEventDataStopColocationAdvertisementCompleteMETA events with requestId field matching the requestId populated by this function.)

If the asynchronous operation is successful, in the corresponding completion event, the runtime must set the XrEventDataStopColocationAdvertisementCompleteMETA::result field to SUCCESS.

If the asynchronous operation is scheduled but not successful, in the corresponding completion event, the runtime must set the XrEventDataStopColocationAdvertisementCompleteMETA::result field to an appropriate error code instead of SUCCESS.

Valid Usage (Implicit)

• The XR_META_colocation_discovery extension must be enabled prior to calling StopColocationAdvertisementMETA
• session must be a valid XrSession handle
• info must be a pointer to a valid XrColocationAdvertisementStopInfoMETA structure
• requestId must be a pointer to an XrAsyncRequestIdFB value

Return Codes

On success, this command returns

• SUCCESS
• SESSION_LOSS_PENDING

On failure, this command returns

• ERROR_FUNCTION_UNSUPPORTED
• ERROR_VALIDATION_FAILURE
• ERROR_RUNTIME_FAILURE
• ERROR_HANDLE_INVALID
• ERROR_INSTANCE_LOST
• ERROR_SESSION_LOST
• ERROR_RUNTIME_UNAVAILABLE
• ERROR_FEATURE_UNSUPPORTED
• ERROR_EXTENSION_NOT_PRESENT

See Also

XrColocationAdvertisementStopInfoMETA, XrEventDataStopColocationAdvertisementCompleteMETA, StartColocationAdvertisementMETA

Parameters:

session - an XrSession in which the colocation discovery will be active.

info - a pointer to XrColocationAdvertisementStopInfoMETA structure to specify the advertisement configuration.

requestId - an output parameter, and the variable it points to will be populated with the ID of this asynchronous request.