XtfCaptureRecordedGameClip

Captures a video clip from the currently running game.

Syntax

HRESULT XtfCaptureRecordedGameClip(
         PCWSTR address,
         PCWSTR fullFileName,
         UINT32 numSeconds
)

Parameters

address
Type: PCWSTR

[in] Address of the console.

fullFileName
Type: PCWSTR

[in] The full file name including path of the file that the video clip will be written to.

numSeconds
Type: UINT32

[in] The number of seconds of video to return from the “current time” backwards. Min is 6 seconds. Max is 300 seconds.

Return value

Type: HRESULT

Returns S_OK on success, otherwise an error code is returned. Possible error codes include the following:

Error Code	Description
0x82323001	The GameDVR service unexpectantly shut down.
0x82323002	There is not enough storage space to save another clip.
0x82323003	StartRecordAsync did not finish or was not called from this instance of ApplicationClipCapture before calling StopRecordAsync.
0x82323004	There are too many concurrent recordings.
0x82323005	HTTP Response text is too big.
0x82323006	Information about an earlier call to StartRecordingAsync is missing.
0x82323007	StopRecordAsync was not called within the alloted time after StartRecordAsync.
0x82323008	The asynchronous call failed but did not return an error code.
0x82323009	Update attempted on a cloud clip where cloud ID is not available.
0x8232300A	There was an error writing to the file.
0x8232300B	Did not find any frames to record. Possible causes include: Game was in the background during the specified time period. Recording was requested too soon after the game was activated.
0x8232300C	Did not find any frames to record. Possible causes include: Game was in the background during the specified time period. Game not running during the specified time period.
0x8232300D	The clip metadata is incorrectly formatted.
0x8232300E	Start time is too old or too far into future.
0x8232300F	Duration of recording is too short or too long. (6 - 300 seconds)
0x82323010	The user or title does not have access to the specified clip.
0x82323011	There is no field to update.
0x82323012	Recording was disabled during the time period requested.
0x82323013	StartRecordAsync was called while another recording is being made.
0x82323014	StopRecordAsync was called but no recording was started.
0x82323015	RecordTimespanAsync was called while another recording is being made.
0x82323016	There was a delay uploading the clip. Upload will be attempted again later. Games can safely ignore this error, or use it to inform the user that the request is still in the queue but will take more time to complete.
0x82323017	There is no game running.
0x82323018	The current title has blocked recording.
0x82323019	The clip hasn’t been uploaded to the cloud yet.
0x8232301A	A guest user was specified for an operation that does not allow it.
0x8232301B	Clip Recording is unavailable because a broadcast is in progress.
0x8C11040D	Title is not running on target console.

Requirements

Header: Declared in XtfApi.h.

Library: Use XtfApi.lib.