Função NdisCmDispatchIncomingDropParty (ndis.h)

  • Artigo

NdisCmDispatchIncomingDropParty notifica um cliente de que ele deve remover uma parte específica em uma VC de vários pontos, geralmente porque o gerenciador de chamadas recebeu uma solicitação pela rede para fechar uma conexão multipoint ativa.

Sintaxe

void NdisCmDispatchIncomingDropParty(
  [in]           NDIS_STATUS DropStatus,
  [in]           NDIS_HANDLE NdisPartyHandle,
  [in, optional] PVOID       Buffer,
  [in]           UINT        Size
);

Parâmetros

[in] DropStatus

Indica o motivo pelo qual essa parte está sendo descartada, geralmente NDIS_STATUS_SUCCESS se a parte remota simplesmente solicitou que sua conexão fosse fechada.

[in] NdisPartyHandle

Especifica o identificador que identifica a parte a ser removida da VC de vários pontos, que deve ter outras partes que ainda estão conectadas.

[in, optional] Buffer

Ponteiro para um buffer residente alocado pelo chamador que contém dados adicionais específicos do protocolo recebidos da parte remota, se houver. Dependendo do meio subjacente, esse ponteiro pode ser NULL.

[in] Size

Especifica o tamanho em bytes do buffer, zero se Buffer for NULL.

Retornar valor

Nenhum

Comentários

No curso de operações de rede normais, um gerenciador de chamadas autônomo A função ProtocolCoReceiveNetBufferLists chama NdisCmDispatchIncomingDropParty com o CloseStatus definido como NDIS_STATUS_SUCCESS porque um cliente remoto em uma conexão de vários pontos chamou NdisClCloseCall.

No entanto, um gerenciador de chamadas também pode chamar NdisCmDispatchIncomingDropParty com um CloseStatus determinado por CM a responsabilidade da própria rede se ocorrerem condições anormais de rede, como a falha de um comutador no caminho entre o cliente local e um ou mais clientes em uma conexão multiponto estabelecida.

Uma chamada para NdisCmDispatchIncomingDropParty faz com que o NDIS chame o cliente Função ProtocolClIncomingDropParty .

Se o NdisPartyHandle identificar a última parte restante na VC fornecida, o CM chamará NdisCmDispatchIncomingCloseCall, em vez de NdisCmDispatchIncomingDropParty.

Somente os gerenciadores de chamadas autônomos, que se registram no NDIS como drivers de protocolo, podem chamar NdisCmDispatchIncomingDropParty. Drivers de miniporto orientados para conexão que fornecem suporte integrado ao gerenciamento de chamadas chamam NdisMCmDispatchIncomingDropParty .

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte NdisCmDispatchIncomingDropParty (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte NdisCmDispatchIncomingDropParty (NDIS 5.1)) no Windows XP.
Plataforma de Destino Área de Trabalho
Cabeçalho ndis.h (inclua Ndis.h)
Biblioteca Ndis.lib
IRQL <= DISPATCH_LEVEL
Regras de conformidade da DDI Irql_CallManager_Function(ndis)

Confira também

NdisClDropParty

NdisCmDispatchIncomingCloseCall NdisMCmDispatchIncomingDropParty

ProtocolClIncomingDropParty

ProtocolCoReceiveNetBufferLists