EVT_WDF_DMA_ENABLER_FILL função de retorno de chamada (wdfdmaenabler.h)
[Aplica-se somente ao KMDF]
A função de retorno de chamada de evento EvtDmaEnablerFill de um driver aloca os buffers de DMA de um dispositivo.
Sintaxe
EVT_WDF_DMA_ENABLER_FILL EvtWdfDmaEnablerFill;
NTSTATUS EvtWdfDmaEnablerFill(
[in] WDFDMAENABLER DmaEnabler
)
{...}
Parâmetros
[in] DmaEnabler
Um identificador para um objeto de habilitador de DMA.
Valor de retorno
EvtDmaEnablerFill deve retornar STATUS_SUCCESS ou outro valor de status para o qual NT_SUCCESS(status) é igual a VERDADEIRO, se não encontrar erros. Caso contrário, essa função de retorno de chamada deve retornar um valor de status para o qual NT_SUCCESS(status) é igual a FALSE.
Observações
Para registrar uma função de retorno de chamada EvtDmaEnablerFill, um driver de função para um dispositivo DMA coloca o endereço da função de retorno de chamada em uma estrutura de WDF_DMA_ENABLER_CONFIG antes que o driver chame WdfDmaEnablerCreate.
Para obter mais informações sobre a função de retorno de chamada EvtDmaEnablerFill, consulte Suporte ao Gerenciamento de Energia para Dispositivos DMA.
A função de retorno de chamada EvtDmaEnablerFill é chamada em IRQL = PASSIVE_LEVEL. Você não deve tornar essa função de retorno de chamada pageable.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Universal |
| versão mínima do KMDF | 1.0 |
| cabeçalho | wdfdmaenabler.h (inclua Wdf.h) |
| IRQL | PASSIVE_LEVEL (consulte a seção Comentários) |