Função NdisMCoIndicateReceiveNetBufferLists (ndis.h)

Artigo
08/07/2023

A função NdisMCoIndicateReceiveNetBufferLists indica que o driver de miniporto recebeu dados da rede.

Sintaxe

void NdisMCoIndicateReceiveNetBufferLists(
  [in] IN NDIS_HANDLE      NdisVcHandle,
  [in] IN PNET_BUFFER_LIST NetBufferLists,
  [in] IN ULONG            NumberOfNetBufferLists,
  [in] IN ULONG            CoReceiveFlags
);

Parâmetros

[in] NdisVcHandle

Um identificador que identifica uma VC (conexão virtual). O driver de miniporte obteve esse identificador como um parâmetro de entrada para sua função MiniportCoCreateVc , quando um cliente configurou uma chamada de saída ou quando o gerenciador de chamadas criou uma VC para um SAP (ponto de acesso de serviço registrado pelo cliente) para indicar uma notificação de chamada de entrada.

[in] NetBufferLists

Uma lista vinculada de estruturas de NET_BUFFER_LIST alocadas pelo driver de miniporto.

[in] NumberOfNetBufferLists

O número de estruturas NET_BUFFER_LIST que estão na lista vinculada de estruturas especificadas pelo NetBufferLists .

[in] CoReceiveFlags

Sinalizadores que definem atributos para a operação de envio. Os sinalizadores podem ser combinados com uma operação OR bit a bit. Para limpar todos os sinalizadores, defina esse parâmetro como zero. NdisMCoIndicateReceiveNetBufferLists dá suporte aos seguintes sinalizadores:

NDIS_RECEIVE_FLAGS_DISPATCH_LEVEL

O IRQL atual é DISPATCH_LEVEL. Para obter mais informações sobre esse sinalizador, consulte Dispatch IRQL Tracking.

NDIS_RECEIVE_FLAGS_RESOURCES

O driver de miniporto recupera a propriedade das estruturas de NET_BUFFER_LIST e quaisquer estruturas NET_BUFFER anexadas imediatamente após o retorno de NdisMCoIndicateReceiveNetBufferLists .

Retornar valor

Nenhum

Comentários

Um driver de miniporto normalmente chama a função NdisMCoIndicateReceiveNetBufferLists de sua função MiniportInterruptDPC . Quando um driver de miniporto chama NdisMCoIndicateReceiveNetBufferLists, ele especifica uma lista de estruturas de NET_BUFFER_LIST no parâmetro NetBufferLists . Em seguida, o NDIS passa as estruturas de NET_BUFFER_LIST para os drivers de protocolo associados.

Os drivers de miniport devem definir o membro SourceHandle de cada estrutura NET_BUFFER_LIST com o mesmo valor que o parâmetro NdisVcHandle para que o NDIS possa retornar as estruturas de NET_BUFFER_LIST para o driver de miniporto correto.

Se um driver de miniporto chamar NdisMCoIndicateReceiveNetBufferLists e limpar o sinalizador NDIS_RECEIVE_FLAGS_RESOURCES no parâmetro CoReceiveFlags , o NDIS retornará as estruturas NET_BUFFER_LIST especificadas pelo NetBufferLists para o driver de miniporte Função MiniportReturnNetBufferLists . Nesse caso, o driver de miniporto não deve recuperar as estruturas de NET_BUFFER_LIST até que o NDIS retorne as estruturas NET_BUFFER_LIST para a função MiniportReturnNetBufferLists do driver de miniport.

Se um driver de miniporto chamar NdisMCoIndicateReceiveNetBufferLists e definir o sinalizador NDIS_RECEIVE_FLAGS_RESOURCES no parâmetro CoReceiveFlags , o driver de miniporto deverá recuperar a propriedade das estruturas NET_BUFFER_LIST imediatamente. Nesse caso, o NDIS não chama a função MiniportReturnNetBufferLists do driver de miniport para retornar as estruturas NET_BUFFER_LIST. Em vez disso, o NDIS retorna as estruturas de NET_BUFFER_LIST para o driver de miniporto quando NdisMCoIndicateReceiveNetBufferLists retorna. O driver de miniporto deve recuperar as estruturas de NET_BUFFER_LIST imediatamente após o retorno de NdisMCoIndicateReceiveNetBufferLists . Para recuperar as estruturas NET_BUFFER_LIST, um driver de miniporte pode chamar de seu próprio Função MiniportReturnNetBufferLists .

Se um driver de miniporto definir o sinalizador NDIS_RECEIVE_FLAGS_RESOURCES no parâmetro CoReceiveFlags , os drivers de protocolo deverão copiar os dados de rede e liberar as estruturas de NET_BUFFER_LIST para o driver de miniporte. Você deve projetar seus drivers de miniporte com estruturas de NET_BUFFER_LIST prealcalizadas suficientes para evitar cópias desnecessárias.

O chamador de NdisMCoIndicateReceiveNetBufferLists deve inicializar corretamente as estruturas de NET_BUFFER_LIST, as estruturas de NET_BUFFER anexadas e quaisquer MDLs (listas de descritores de memória) anexadas.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Com suporte no NDIS 6.0 e posterior.
Plataforma de Destino	Área de Trabalho
Cabeçalho	ndis.h (inclua Ndis.h)
Biblioteca	Ndis.lib
IRQL	<= DISPATCH_LEVEL
Regras de conformidade de DDI	Irql_MCO_Function(ndis)