Funzione PcwCloseInstance (wdm.h)

La funzione chiude un'istanza PcwCloseInstance del contatore creata usando PcwCreateInstance. La maggior parte degli sviluppatori userà una funzione CloseXxx generata da CTRPP anziché chiamare direttamente questa funzione.

Sintassi

void PcwCloseInstance(
  [in] PPCW_INSTANCE Instance
);

Parametri

[in] Instance

Puntatore all'istanza del contatore da chiudere.

Valore restituito

nessuno

Osservazioni

Usare la funzione per creare un'istanza PcwCreateInstance del contatore.

Non è possibile chiamare PcwCloseInstance un'istanza se è già stato chiamato PcwUnregister per la registrazione del contatore corrispondente. Quando si annulla la registrazione del contatore, tutte le istanze rimanenti vengono chiuse per l'utente. Chiudendoli di nuovo si arresterà in modo anomalo il sistema.

Funzione CloseXxx generata da CTRPP

La maggior parte degli sviluppatori non deve chiamare PcwCloseInstance direttamente. Verranno invece compilati un manifesto con lo strumento CTRPP e useranno la funzione CloseXxx dall'intestazione generata da CTRPP. La funzione generata avrà un aspetto simile al seguente:

EXTERN_C FORCEINLINE VOID
CloseMyCounterset(
    __in PPCW_INSTANCE Instance
    )
{
    PAGED_CODE();

    PcwCloseInstance(Instance);
}

La funzione Close generata da CTRPP sarà denominata PrefixCloseCounterSet. Il prefisso è in genere vuoto, ma può essere presente se il -prefix parametro è stato usato nella riga di comando CTRPP. CounterSet è il nome del contatore, come specificato nel manifesto.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 7 e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	IRQL <= APC_LEVEL

Vedi anche

Funzione PcwCreateInstance