Compartilhar via


Função WdfCommonBufferGetLength (wdfcommonbuffer.h)

[Aplica-se somente ao KMDF]

O método WdfCommonBufferGetLength retorna o comprimento de um buffer comum especificado.

Sintaxe

size_t WdfCommonBufferGetLength(
  [in] WDFCOMMONBUFFER CommonBuffer
);

Parâmetros

[in] CommonBuffer

Um identificador para um objeto de buffer comum que o driver obteve por uma chamada anterior para WdfCommonBufferCreate.

Valor de retorno

WdfCommonBufferGetLength retorna o comprimento, em bytes, do buffer associado ao buffer comum especificado pelo parâmetro CommonBuffer.

Uma verificação de bug ocorre se o driver fornece um identificador de objeto inválido.

Observações

Para obter mais informações sobre buffers comuns, consulte Usando buffers comuns

Exemplos

O exemplo de código a seguir obtém o comprimento de um buffer comum especificado.

size_t bufferLength;

bufferLength = WdfCommonBufferGetLength(DevExt->CommonBuffer); 

Requisitos

Requisito Valor
da Plataforma de Destino Universal
versão mínima do KMDF 1.0
cabeçalho wdfcommonbuffer.h (inclua WdfCommonBuffer.h)
biblioteca Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.)
IRQL <= DISPATCH_LEVEL
regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte também

WdfCommonBufferCreate