Partilhar via


Função WdfMemoryAssignBuffer (wdfmemory.h)

[Aplica-se a KMDF e UMDF]

O método WdfMemoryAssignBuffer atribui um buffer especificado a um objeto de memória que um driver criou chamando WdfMemoryCreatePreallocated.

Sintaxe

NTSTATUS WdfMemoryAssignBuffer(
  [in] WDFMEMORY Memory,
  [in] PVOID     Buffer,
  [in] size_t    BufferSize
);

Parâmetros

[in] Memory

Um identificador para um objeto de memória de estrutura que foi obtido chamando WdfMemoryCreatePreallocated.

[in] Buffer

Um ponteiro para um buffer fornecido pelo driver.

[in] BufferSize

O tamanho diferente de zero, em bytes, do buffer que buffer aponta.

Valor de retorno

WdfMemoryAssignBuffer retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, esse método poderá retornar um dos seguintes valores:

Código de retorno Descrição
STATUS_INVALID_PARAMETER
Um parâmetro inválido foi detectado.
 

Esse método também pode retornar outros valores NTSTATUS .

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

Observações

O método pode atribuir um buffer a um objeto de memória que WdfMemoryCreatePreallocated criada, mas não a um objeto de memória que WdfMemoryCreate criada.

O buffer para o qual o buffer pontos de parâmetro pode ser alocado do pool de memória paginável ou não paginável. Se o driver alocar o buffer do pool de páginas ou se o buffer for do pool de páginas porque ele veio de um aplicativo no modo de usuário, o driver deverá acessar o buffer somente em < DISPATCH_LEVEL IRQL. (Observe que as funções de retorno de chamada EvtCleanupCallback do driver e EvtDestroyCallback, se fornecidas, podem ser chamadas em IRQL <= DISPATCH_LEVEL.)

Para obter mais informações sobre objetos de memória da estrutura, consulte Usando buffers de memória.

Exemplos

O exemplo de código a seguir aloca um buffer e atribui o buffer a um objeto de memória da estrutura.

PVOID  pNewBuffer = NULL;

pNewBuffer = ExAllocatePoolWithTag(
                                   NonPagedPool,
                                   NEW_BUFFER_SIZE,
                                   MY_DRIVER_TAG
                                   );
if (pNewBuffer == NULL){
    goto Error;
}

status = WdfMemoryAssignBuffer(
                               memHandle,
                               pNewBuffer,
                               NEW_BUFFER_SIZE
                               );

Requisitos

Requisito Valor
da Plataforma de Destino Universal
versão mínima do KMDF 1.0
versão mínima do UMDF 2.0
cabeçalho wdfmemory.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Qualquer nível
regras de conformidade de DDI BufAfterReqCompletedIntIoctlA(kmdf), BufAfterReqCompletedIoctlA(kmdf), BufAfterReqCompletedReadA(kmdf), BufAfterReqCompletedWriteA(kmdf), DriverCreate(kmdf), MemAfterReqCompletedIntIoctlA(kmdf), MemAfterReqCompletedIoctlA(kmd, MemAfterReqCompletedReadA(kmdf), MemAfterReqCompletedWriteA(kmdf)

Consulte também

ExAllocatePoolWithTag

WdfMemoryCreatePreallocated