Função WdfDmaEnablerGetMaximumScatterGatherElements (wdfdmaenabler.h)
[Aplica-se somente ao KMDF]
O método WdfDmaEnablerGetMaximumScatterGatherElements retorna o número máximo de elementos de dispersão/coleta aos quais o dispositivo e o driver dão suporte para um objeto habilitador de DMA especificado.
Sintaxe
size_t WdfDmaEnablerGetMaximumScatterGatherElements(
[in] WDFDMAENABLER DmaEnabler
);
Parâmetros
[in] DmaEnabler
Um identificador para um objeto de habilitador de DMA que o driver obteve de uma chamada anterior para WdfDmaEnablerCreate.
Retornar valor
Se o driver anteriormente chamado WdfDmaEnablerSetMaximumScatterGatherElements, WdfDmaEnablerGetMaximumScatterGatherElements retornará o valor especificado pelo driver na chamada anterior. Caso contrário, WdfDmaEnablerGetMaximumScatterGatherElements retornará WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, o que indica que não há limite para o número de elementos de dispersão/coleta.
Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.
Comentários
Para obter mais informações sobre esse método, consulte Habilitando transações de DMA.
Exemplos
O exemplo de código a seguir obtém o número máximo de elementos de dispersão/coleta para um objeto habilitador de DMA especificado.
size_t maxElements;
maxElements = WdfDmaEnablerGetMaximumScatterGatherElements(DmaEnabler);
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdfdmaenabler.h (inclua Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.) |
| IRQL | <=DISPATCH_LEVEL |
| Regras de conformidade da DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |