> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturestartuserrecord.md) 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](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcaptureuserrecordingresult.md)\*

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](https://docs.xbox.com/pt-BR/reference/system/xappcapture/xappcapture_errors.md) para valores retornados diferentes de `S_OK`.

## Comentários

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

> [!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.

```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](https://docs.xbox.com/pt-BR/reference/system/xappcapture/xappcapture_members.md)


## Related topics

- [XAppCaptureUserRecordingResult](https://docs.xbox.com/pt-BR/reference/system/xappcapture/structs/xappcaptureuserrecordingresult.md)
- [XAppCaptureStartUserRecord](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturestartuserrecord.md)
- [XAppCapture (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xappcapture/xappcapture_members.md)
- [XAppCaptureCancelUserRecord](https://docs.xbox.com/pt-BR/reference/system/xappcapture/functions/xappcapturecanceluserrecord.md)
- [Códigos de erro de XAppCapture](https://docs.xbox.com/pt-BR/reference/system/xappcapture/xappcapture_errors.md)