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 |
---|---|
|
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) |