Método IWDFIoRequest::GetWriteParameters (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 GetWriteParameters recupera os parâmetros de solicitação para uma solicitação de tipo de gravação.

Sintaxe

void GetWriteParameters(
  [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 gravar. Para recuperar os dados para gravação, o driver chama o método IWDFIoRequest::GetInputMemory .

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 gravar no dispositivo ou no arquivo no dispositivo. Se o dispositivo não der suporte a endereços de gravação 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 WriteFile ou WriteFileEx 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 GetWriteParameters falhará se o tipo de solicitação não for um tipo de gravação.

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.

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