> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAppCaptureStopUserRecord

> XAppCaptureStopUserRecord

# XAppCaptureStopUserRecord

Interrompe uma gravação de usuário em andamento iniciada por meio de [XAppCaptureStartUserRecord](/pt-BR/reference/system/xappcapture/functions/xappcapturestartuserrecord) e especificada pela ID informada. Os usuários receberão uma notificação do sistema indicando que uma gravação foi salva, e a gravação ficará acessível ao usuário. O suporte do Windows para esta API será adicionado em uma versão futura.

## Sintaxe

```cpp theme={null}
HRESULT XAppCaptureStopUserRecord(
    const char* localId,
    XAppCaptureUserRecordingResult* result
)
```

### Parâmetros

*localId* \_In\_\
Tipo: const char\*

Identificador que representa o usuário que está solicitando a gravação.

*result* \_Out\_\
Tipo: [XAppCaptureUserRecordingResult](/pt-BR/reference/system/xappcapture/structs/xappcaptureuserrecordingresult)\*

Na conclusão bem-sucedida da função, contém informações sobre o clipe gravado.

### Valor retornado

Tipo: HRESULT

Resultado da função. Consulte [Códigos de erro de XAppCapture](/pt-BR/reference/system/xappcapture/xappcapture_errors) para valores retornados diferentes de `S_OK`.

## Comentários

Pressupõe que localIdOfUserRecording contenha uma ID local retornada por [XAppCaptureStartUserRecord](/pt-BR/reference/system/xappcapture/functions/xappcapturestartuserrecord).

<Note>Se esta API não for chamada antes que a gravação atinja seu limite máximo de tempo, a gravação será interrompida e excluída (não salva). Chamar esta API para interromper a gravação depois que o limite de tempo tiver passado retornará um código de erro.</Note>

```cpp theme={null}
XAppCaptureUserRecordingResult userRecording = { 0 };

if (FAILED_LOG(XAppCaptureStopUserRecord(localIdOfUserRecording, &userRecording)))
{
    return;
}

appLog.AddLog("Recording stopped: Start timestamp: %llu, Duration (ms): %llu, File Size (bytes): %llu, Width: %d, Height: %d, Encoding: %d, Color Format: %d\n",
    userRecording.clipStartTimestamp, userRecording.durationInMilliseconds, userRecording.fileSizeInBytes, userRecording.width, userRecording.height, userRecording.encoding, userRecording.colorFormat);
```

## Requisitos

**Cabeçalho:** XAppCapture.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatíveis:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[Membros de XAppCapture](/pt-BR/reference/system/xappcapture/xappcapture_members)


## Related topics

- [XAppCaptureStopUserRecord](/zh-CN/reference/system/xappcapture/functions/xappcapturestopuserrecord.md)
- [XAppCaptureStartUserRecord](/reference/system/xappcapture/functions/xappcapturestartuserrecord.md)
- [XAppCaptureUserRecordingResult](/ko/reference/system/xappcapture/structs/xappcaptureuserrecordingresult.md)