Partilhar via

Função BuildIoRingReadFile (ioringapi.h)

Executa uma leitura assíncrona de um arquivo usando um anel de E/S. Essa operação é semelhante a chamar ReadFileEx.

Sintaxe

HRESULT BuildIoRingReadFile(
  HIORING           ioRing,
  IORING_HANDLE_REF fileRef,
  IORING_BUFFER_REF dataRef,
  UINT32            numberOfBytesToRead,
  UINT64            fileOffset,
  UINT_PTR          userData,
  IORING_SQE_FLAGS  sqeFlags
);

Parâmetros

ioRing

Um HIORING que representa um identificador para o anel de E/S que executará a operação de leitura.

fileRef

Um IORING_HANDLE_REF especificando o arquivo a ser lido.

dataRef

Um IORING_BUFFER_REF especificando o buffer no qual o arquivo é lido. O buffer fornecido deve ter um tamanho de pelo menos bytes numberOfBytesToRead .

numberOfBytesToRead

O número de bytes a serem lidos.

fileOffset

O deslocamento para o arquivo para começar a ler.

userData

Um valor UINT_PTR que identifica a operação de leitura de arquivo. Especifique esse valor ao cancelar a operação com uma chamada para BuildIoRingCancelRequest. Se um aplicativo implementar o comportamento de cancelamento para a operação, o valor userData deverá ser exclusivo. Caso contrário, o valor é tratado como opaco pelo sistema e pode ser qualquer coisa, incluindo 0.

sqeFlags

Valor de retorno

Retorna um HRESULT incluindo, mas não limitado ao seguinte:

Value Description
S_OK Êxito
IORING_E_SUBMISSION_QUEUE_FULL A fila de envio está cheia e nenhuma entrada adicional está disponível para compilação. O aplicativo deve enviar as entradas existentes e aguardar a conclusão de algumas delas antes de adicionar mais operações à fila.
IORING_E_UNKNOWN_REQUIRED_FLAG O aplicativo forneceu um sinalizador necessário que não é conhecido pela implementação. O código da biblioteca deve verificar o campo IoRingVersion do IORING_INFO obtido de uma chamada para GetIoRingInfo para determinar a versão da API de um anel de E/S que determina as operações e sinalizadores com suporte. Os aplicativos devem saber a versão usada para criar o anel de E/S e, portanto, não devem fornecer sinalizadores sem suporte no runtime.

Observações

Verifique o suporte ao anel de E/S para operações de arquivo de leitura chamando IsIoRingOpSupported e especificando IORING_OP_READ para o parâmetro op .

Requirements

Requirement Value
Cliente mínimo suportado Windows Build 22000
Servidor mínimo compatível Windows Build 22000
Header ioringapi.h
Library kernel32. Lib
  • Last updated on