Compartilhar via

Função BuildIoRingReadFile (ioringapi.h)

  • Artigo

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 a ser lido.

userData

Um valor UINT_PTR que identifica a operação de leitura do 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

Retornar valor

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

Valor Descrição
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 obrigatório que não é conhecido pela implementação. O código da biblioteca deve marcar 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 os 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 em runtime.

Comentários

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 .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Build 22000
Servidor mínimo com suporte Windows Build 22000
Cabeçalho ioringapi.h