Método IWDFIoRequest::GetReadParameters (wudfddi.h)

  • Artigo

Aviso

O UMDF 2 é a versão mais recente do UMDF e substitui o UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.

O método GetReadParameters recupera os parâmetros de solicitação para uma solicitação de tipo de leitura.

Sintaxe

void GetReadParameters(
  [out, optional] SIZE_T   *pSizeInBytes,
  [out, optional] LONGLONG *pullOffset,
  [out, optional] ULONG    *pulKey
);

Parâmetros

[out, optional] pSizeInBytes

Um ponteiro para uma variável que recebe o tamanho, em bytes, para leitura. Para recuperar os dados para leitura, o driver chama o método IWDFIoRequest::GetOutputMemory .

Esse parâmetro é opcional. O driver poderá passar NULL se não exigir as informações.

[out, optional] pullOffset

Um ponteiro para uma variável que recebe o deslocamento, em bytes, para começar a ler do dispositivo ou do arquivo no dispositivo. Se o dispositivo não der suporte a endereços de leitura absolutos, pullOffset poderá ser ignorado. Para obter mais informações, consulte a seção Comentários a seguir.

Os aplicativos cliente especificam esse valor nos membros Offset e OffsetHigh da estrutura OVERLAPPED. Um ponteiro para OVERLAPPED é passado na função ReadFile ou ReadFileEx do Microsoft Win32.

Esse parâmetro é opcional. O driver poderá passar NULL se não exigir as informações.

[out, optional] pulKey

Um ponteiro para uma variável que recebe uma chave que o driver pode usar para classificar a solicitação de E/S de uma maneira que o driver determina.

Esse parâmetro é opcional. O driver poderá passar NULL se não exigir as informações.

Retornar valor

Nenhum

Comentários

Uma chamada para GetReadParameters falhará se o tipo de solicitação não for um tipo de leitura.

Para dispositivos que dão suporte ao endereçamento (por exemplo, um dispositivo de disco), o valor para o qual o parâmetro pullOffset aponta normalmente é o deslocamento de bytes para o dispositivo. Para dispositivos que não dão suporte ao endereçamento (por exemplo, uma porta serial), o driver pode ignorar o valor em pullOffset.

Embora o driver possa opcionalmente especificar NULL para cada um dos parâmetros pSizeInBytes, pullOffset e pulKey , o driver deve especificar pelo menos um parâmetro não NULL para GetReadParameters executar com êxito.

Requisitos

Requisito Valor
Fim do suporte Indisponível no UMDF 2.0 e posterior.
Plataforma de Destino Área de Trabalho
Versão mínima do UMDF 1.5
Cabeçalho wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Confira também