PcwCloseInstance-Funktion (wdm.h)
Die PcwCloseInstance Funktion schließt eine Counterset-instance, die mit PcwCreateInstance erstellt wurde. Die meisten Entwickler verwenden eine von CTRPP generierte CloseXxx-Funktion, anstatt diese Funktion direkt aufzurufen.
Syntax
void PcwCloseInstance(
[in] PPCW_INSTANCE Instance
);
Parameter
[in] Instance
Ein Zeiger auf die Zu schließende Zählermenge instance.
Rückgabewert
Keine
Bemerkungen
Verwenden Sie die PcwCreateInstance -Funktion, um eine Counterset-instance zu erstellen.
Sie können keine instance aufrufenPcwCloseInstance, wenn Sie bereits PcwUnregister für die entsprechende Countersetregistrierung aufgerufen haben. Wenn Sie die Registrierung des Countersets aufheben, werden alle verbleibenden Instanzen für Sie geschlossen. Wenn Sie sie erneut schließen, stürzt das System ab.
CTRPP-generierte CloseXxx-Funktion
Die meisten Entwickler müssen nicht direkt aufrufen PcwCloseInstance . Stattdessen kompilieren sie ein Manifest mit dem CTRPP-Tool und verwenden die CloseXxx-Funktion aus dem von CTRPP generierten Header. Die generierte Funktion sieht wie folgt aus:
EXTERN_C FORCEINLINE VOID
CloseMyCounterset(
__in PPCW_INSTANCE Instance
)
{
PAGED_CODE();
PcwCloseInstance(Instance);
}
Die von CTRPP generierte Close-Funktion heißt PräfixschließenCounterSet. Das Präfix ist in der Regel leer, kann aber vorhanden sein, wenn der -prefix Parameter in der CTRPP-Befehlszeile verwendet wurde. CounterSet ist der Name der Leistungsgruppe, wie im Manifest angegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 7 und späteren Windows-Versionen. |
| Zielplattform | Universell |
| Header | wdm.h (include Wdm.h, Ntddk.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | IRQL <= APC_LEVEL |