PROTOCOL_CL_DROP_PARTY_COMPLETE função de retorno de chamada (ndis.h)
A função ProtocolClDropPartyComplete é usada por clientes NDIS orientados à conexão que configuram conexões de vários pontos. Esses clientes devem ter funções ProtocolClDropPartyComplete para concluir as operações assíncronas que iniciam com
NdisClDropParty. Caso contrário, essa função de de ProtocolClDropPartyComplete do driver de protocolo pode simplesmente retornar o controle.
Sintaxe
PROTOCOL_CL_DROP_PARTY_COMPLETE ProtocolClDropPartyComplete;
void ProtocolClDropPartyComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE ProtocolPartyContext
)
{...}
Parâmetros
[in] Status
Especifica o status final da operação drop-party iniciada pelo cliente, que pode ser um dos seguintes:
NDIS_STATUS_SUCCESS
O partido foi removido. O NdisPartyHandle que representava essa parte, que o cliente armazenava em sua área de ProtocolPartyContext, agora é inválido.
NDIS_STATUS_FAILURE
A parte fornecida foi a última restante no VC de vários pontos do cliente. Portanto, o cliente deve chamar NdisClCloseCall para remover essa parte.
[in] ProtocolPartyContext
Especifica o identificador para a área de contexto por parte do cliente, que o cliente forneceu originalmente ao NDIS quando chamou NdisClAddParty ou NdisClMakeCall.
Valor de retorno
Nenhum
Observações
Uma chamada para ProtocolClDropPartyComplete indica que o gerenciador de chamadas concluiu o processamento da solicitação iniciada pela chamada anterior do cliente para NdisClDropParty. ProtocolClDropPartyComplete pode liberar a área de contexto por parte alocada pelo cliente ou prepará-la para reutilização em uma chamada subsequente para NdisClAddParty.
Se o cliente estiver no processo de remover um VC de vários pontos que ele criou, ProtocolClDropPartyComplete poderá chamar NdisClDropParty com qualquer NdisPartyHandle válido para uma das partes restantes no VC multipoint ativo do cliente. Se apenas mais uma parte permanecer em seu VC multiponto, o cliente deverá remover essa parte passando seu NdisPartyHandle para NdisClCloseCall.
exemplos de
Para definir uma função ProtocolClDropPartyComplete, 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 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 gravar drivers para o sistema operacional Windows.Por exemplo, para definir uma função ProtocolClDropPartyComplete chamada "MyClDropPartyComplete", use o tipo PROTOCOL_CL_DROP_PARTY_COMPLETE conforme mostrado neste exemplo de código:
PROTOCOL_CL_DROP_PARTY_COMPLETE MyClDropPartyComplete;
Em seguida, implemente sua função da seguinte maneira:
_Use_decl_annotations_
VOID
MyClDropPartyComplete(
NDIS_STATUS Status,
NDIS_HANDLE ProtocolPartyContext
)
{...}
O tipo de função PROTOCOL_CL_DROP_PARTY_COMPLETE é 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 PROTOCOL_CL_DROP_PARTY_COMPLETE 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 |
|---|---|
| de cliente com suporte mínimo | Com suporte para drivers NDIS 6.0 e NDIS 5.1 (consulte ProtocolClDropPartyComplete (NDIS 5.1)) no Windows Vista. Com suporte para drivers NDIS 5.1 (consulte ProtocolClDropPartyComplete (NDIS 5.1)) no Windows XP. |
| da Plataforma de Destino | Windows |
| cabeçalho | ndis.h (inclua Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |