> ## 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.

# OpenFile

> IDStorageFactoryX::OpenFile

# IDStorageFactoryX::OpenFile

Abre um arquivo para acesso do DirectStorage.

## Sintaxe

```cpp theme={null}
HRESULT OpenFile(  
         const WCHAR *path,  
         REFIID riid,  
         void **ppv  
)  
```

### Parâmetros

*path*   \_In\_z\_\
Tipo: WCHAR \*

Caminho do arquivo a ser aberto.

*riid*\
Tipo: REFIID

Especifica a interface de arquivo do DirectStorage, como `__uuidof(IDStorageFileX)`.

*ppv*   \_COM\_Outptr\_\
Tipo: void \*\*

Recebe um objeto que representa o arquivo aberto.

### Valor retornado

Tipo: HRESULT

Código de erro HRESULT padrão.

## Comentários

O arquivo especificado deve estar armazenado em um dispositivo NVM Express (NVMe) compatível com o DirectStorage.

Um arquivo é fechado implicitamente quando a última referência ao objeto `IDStorageFileX` correspondente é liberada. Para fechar um arquivo explicitamente, chame [IDStorageFileX::Close](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageFileX/methods/idstoragefilex_close.md).

Para obter mais informações, consulte a seção "IDStorageFileX" em [Visão geral do DirectStorage](https://docs.xbox.com/pt-BR/build/console-features/storage/directstorage/directstorage-overview.md).

## Requisitos

**Cabeçalho:** dstorage\_xs.h

**Biblioteca:** dstorage\_xs.lib

**Plataformas compatíveis:** consoles XBOX Series

## Confira também

[IDStorageFactoryX](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageFactoryX/idstoragefactoryx.md)\
[DStorage](https://docs.xbox.com/pt-BR/reference/system/dstorage/dstorage_members.md)


## Related topics

- [IDStorageFileX::Close](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageFileX/methods/idstoragefilex_close.md)
- [IDStorageFileX (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageFileX/idstoragefilex.md)
- [GetHandle](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageFileX/methods/idstoragefilex_gethandle.md)
- [IDStorageFactoryX (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/system/dstorage/interfaces/IDStorageFactoryX/idstoragefactoryx.md)
- [Visão geral do DirectStorage](https://docs.xbox.com/pt-BR/build/console-features/storage/directstorage/directstorage-overview.md)