PROTOCOL_CL_DROP_PARTY_COMPLETE funzione di callback (ndis.h)
La funzione ProtocolClDropPartyComplete viene usata dai client NDIS orientati alla connessione che configurano connessioni multipoint. Tali client devono avere funzioni ProtocolClDropPartyComplete per completare le operazioni asincrone avviate con
NdisClDropParty. In caso contrario, tale funzione ProtocolClDropPartyComplete del driver di protocollo può semplicemente restituire il controllo.
Sintassi
PROTOCOL_CL_DROP_PARTY_COMPLETE ProtocolClDropPartyComplete;
void ProtocolClDropPartyComplete(
[in] NDIS_STATUS Status,
[in] NDIS_HANDLE ProtocolPartyContext
)
{...}
Parametri
[in] Status
Specifica lo stato finale dell'operazione di eliminazione avviata dal client, che può essere uno dei seguenti:
NDIS_STATUS_SUCCESS
La festa è stata eliminata. NdisPartyHandle che rappresentava questa parte, che il client archiviato nell'area ProtocolPartyContext, non è ora valido.
NDIS_STATUS_FAILURE
La parte specificata era l'ultima rimanente nel VC multipoint del client. Pertanto, il client deve chiamare NdisClCloseCall per eliminare questa parte.
[in] ProtocolPartyContext
Specifica l'handle nell'area di contesto per parti del client, che il client originariamente fornito a NDIS quando ha chiamato NdisClAddParty o NdisClMakeCall.
Valore restituito
nessuno
Osservazioni
Una chiamata a ProtocolClDropPartyComplete indica che il gestore chiamate ha completato l'elaborazione della richiesta avviata dalla chiamata precedente del client a NdisClDropParty. ProtocolClDropPartyComplete può rilasciare l'area di contesto allocata dal client per parti o prepararla per il riutilizzo in una chiamata successiva a NdisClAddParty.
Se il client si trova nel processo di riduzione di un vc a più punti creato, ProtocolClDropPartyComplete può chiamare NdisClDropParty con qualsiasi NdisPartyHandle valido in una delle parti rimanenti nel vc multipoint attivo del client. Se solo una sola parte rimane nel vc multipoint, il client deve eliminare tale parte passando il relativo NdisPartyHandle a NdisClCloseCall.
Esempi
Per definire una funzione ProtocolClDropPartyComplete , è prima necessario specificare una dichiarazione di funzione che identifica il tipo di funzione che si sta definendo. Windows fornisce un set di tipi di funzione per i driver. La dichiarazione di una funzione usando i tipi di funzione consente l'analisi del codice per i driver, il verifica driver statico (SDV) e altri strumenti di verifica trovano errori ed è un requisito per la scrittura di driver per il sistema operativo Windows.Ad esempio, per definire una funzione ProtocolClDropPartyComplete denominata "MyClDropPartyComplete ", usare il tipo di PROTOCOL_CL_DROP_PARTY_COMPLETE come illustrato in questo esempio di codice:
PROTOCOL_CL_DROP_PARTY_COMPLETE MyClDropPartyComplete;
Implementare quindi la funzione come indicato di seguito:
_Use_decl_annotations_
VOID
MyClDropPartyComplete(
NDIS_STATUS Status,
NDIS_HANDLE ProtocolPartyContext
)
{...}
Il tipo di funzione PROTOCOL_CL_DROP_PARTY_COMPLETE è definito nel file di intestazione Ndis.h. Per identificare in modo più accurato gli errori durante l'esecuzione degli strumenti di analisi del codice, assicurarsi di aggiungere l'annotazione Use_decl_annotations alla definizione della funzione. L'annotazione Use_decl_annotations garantisce che vengano usate le annotazioni applicate al tipo di funzione PROTOCOL_CL_DROP_PARTY_COMPLETE nel file di intestazione. Per altre informazioni sui requisiti per le dichiarazioni di funzione, vedere Dichiarazione di funzioni tramite tipi di ruolo per i driver NDIS.
Per informazioni su Use_decl_annotations, vedere Annotazione del comportamento della funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere ProtocolClDropPartyComplete (NDIS 5.1) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere ProtocolClDropPartyComplete (NDIS 5.1) in Windows XP. |
| Piattaforma di destinazione | Windows |
| Intestazione | ndis.h (includere Ndis.h) |
| IRQL | <= DISPATCH_LEVEL |