MINIPORT_PROCESS_SG_LIST função de retorno de chamada (ndis.h)

Um driver de miniporta master de barramento fornece uma função MiniportProcessSGList para processar listas de dispersão/coleta de dados de rede.

Nota Você deve declarar a função usando o tipo MINIPORT_PROCESS_SG_LIST . Para obter mais informações, consulte a seção Exemplos a seguir.

 

Sintaxe

MINIPORT_PROCESS_SG_LIST MiniportProcessSgList;

void MiniportProcessSgList(
  [in] PDEVICE_OBJECT pDO,
  [in] PVOID Reserved,
  [in] PSCATTER_GATHER_LIST pSGL,
  [in] PVOID Context
)
{...}

Parâmetros

[in] pDO

Os drivers de miniport devem ignorar esse parâmetro.

[in] Reserved

Os drivers de miniport devem ignorar esse parâmetro.

[in] pSGL

Um ponteiro para um buffer de lista de dispersão/coleta. Isso não é necessariamente o mesmo buffer que aquele que o driver especificou na chamada para o Função NdisMAllocateNetBufferSGList

[in] Context

Um ponteiro para uma área de contexto que o driver de miniporto criou antes de chamar NdisMAllocateNetBufferSGList.

Retornar valor

Nenhum

Comentários

Miniportores chamam o Função NdisMRegisterScatterGatherDma para registrar uma função MiniportProcessSGList . Quando um driver de miniporto chama NdisMAllocateNetBufferSGList para criar uma lista de dispersão/coleta, o NDIS chama HAL para criar a lista.

O NDIS chamará a função MiniportProcessSGList do driver de miniport se NdisMAllocateNetBufferSGList for bem-sucedido. No entanto, um retorno de êxito dessa função não garante que o retorno de chamada já tenha sido invocado; ele pode ser invocado de forma assíncrona.

Quando o NDIS chama MiniportProcessSGList, o driver pode enviar a estrutura NET_BUFFER para o hardware. MiniportProcessSGList envia os endereços físicos da lista de dispersão/coleta para o DMA da NIC e emite um comando de envio para a NIC.

HAL pode chamar MiniportProcessSGList antes ou depois que o NDIS retorna de NdisMAllocateNetBufferSGList. Portanto, os gravadores de driver não devem assumir que a chamada é feita dentro do contexto de NdisMAllocateNetBufferSGList.

O NDIS chama MiniportProcessSGList em IRQL = DISPATCH_LEVEL.

Exemplos

Para definir uma função MiniportProcessSGList , primeiro você deve fornecer uma declaração de função que identifique o tipo de função que você está definindo. O Windows fornece um conjunto de tipos de função para drivers. Declarar uma função usando os tipos de função ajuda a Análise de Código para Drivers, SDV ( Verificador de Driver Estático ) e outras ferramentas de verificação a encontrar erros e é um requisito para escrever drivers para o sistema operacional Windows.

Por exemplo, para definir uma função MiniportProcessSGList chamada "MyProcessSGList", use o tipo MINIPORT_PROCESS_SG_LIST conforme mostrado neste exemplo de código:

MINIPORT_PROCESS_SG_LIST MyProcessSGList;

Em seguida, implemente sua função da seguinte maneira:

_Use_decl_annotations_
VOID
 MyProcessSGList(
    PDEVICE_OBJECT  pDO,
    PVOID  Reserved,
    PSCATTER_GATHER_LIST  pSGL,
    PVOID  Context
    )
  {...}

O tipo de função MINIPORT_PROCESS_SG_LIST é definido no arquivo de cabeçalho Ndis.h. Para identificar erros com mais precisão ao executar as ferramentas de análise de código, adicione a anotação Use_decl_annotations à sua definição de função. A anotação Use_decl_annotations garante que as anotações aplicadas ao tipo de função MINIPORT_PROCESS_SG_LIST no arquivo de cabeçalho sejam usadas. Para obter mais informações sobre os requisitos para declarações de função, consulte Declarando funções usando tipos de função de função para drivers NDIS.

Para obter informações sobre Use_decl_annotations, consulte Anotando o comportamento da função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no NDIS 6.0 e posterior.
Plataforma de Destino	Windows
Cabeçalho	ndis.h (inclua Ndis.h)
IRQL	DISPATCH_LEVEL

Confira também

NdisMAllocateNetBufferSGList

NdisMRegisterScatterGatherDma