Função WdfDmaEnablerSetMaximumScatterGatherElements (wdfdmaenabler.h)

  • Artigo

[Aplica-se somente ao KMDF]

O método WdfDmaEnablerSetMaximumScatterGatherElements define o número máximo de elementos de dispersão/coleta compatíveis com um dispositivo para um objeto habilitador de DMA especificado.

Sintaxe

void WdfDmaEnablerSetMaximumScatterGatherElements(
  [in] WDFDMAENABLER DmaEnabler,
  [in] size_t        MaximumFragments
);

Parâmetros

[in] DmaEnabler

Um identificador para um objeto de habilitador de DMA que o driver obteve de uma chamada anterior para WdfDmaEnablerCreate.

[in] MaximumFragments

O número máximo de elementos de dispersão/coleta que o driver e o dispositivo podem dar suporte.

Retornar valor

Nenhum

Comentários

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Se o driver chamar WdfDmaEnablerSetMaximumScatterGatherElements, ele deverá fazer isso na função de retorno de chamada EvtDriverDeviceAdd ou EvtDevicePrepareHardware .

Se o driver não chamar WdfDmaEnablerSetMaximumScatterGatherElements, a estrutura usará um valor padrão de WDF_DMA_ENABLER_UNLIMITED_FRAGMENTS, o que significa que não há limite para o número de elementos de dispersão/coleta.

Para obter mais informações sobre esse método, consulte Habilitando transações de DMA.

Exemplos

O exemplo de código a seguir define o número máximo de elementos de dispersão/coleta para um objeto de habilitador de DMA especificado.

WdfDmaEnablerSetMaximumScatterGatherElements(
                                             DmaEnabler, 
                                             NIC_MAX_PHYS_BUF_COUNT
                                             );

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 PASSIVE_LEVEL
Regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WdfDmaEnablerCreate

WdfDmaEnablerGetMaximumScatterGatherElements