PcwCloseInstance-Funktion (wdm.h)

  • Artikel

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

Weitere Informationen

PcwCreateInstance-Funktion