PcwUnregister-Funktion (wdm.h)

Die PcwUnregister Funktion schließt die angegebene Zählersetregistrierung. Die meisten Entwickler verwenden eine von CTRPP generierte UnregisterXxx-Funktion, anstatt diese Funktion direkt aufzurufen.

Syntax

void PcwUnregister(
  PPCW_REGISTRATION Registration
);

Parameter

Registration

[in Ein Zeiger auf die Registrierung, die geschlossen wird.

Rückgabewert

Keine

Bemerkungen

Die PcwUnregister Funktion schließt die angegebene Zählersetregistrierung. Instanzen, die der Countersetregistrierung gehören, werden automatisch geschlossen. Auf diese Instanzen sollte der Anbieter nicht zugreifen, während die Registrierung des Countersets aufgehoben wird oder nachdem die Registrierung des Countersets aufgehoben wurde.

Bevor der Anbieter diese Funktion verwendet, muss der Anbieter die PcwRegister-Funktion aufrufen, um eine Registrierung zu erstellen.

CTRPP-generierte UnregisterXxx-Funktion

Die meisten Entwickler müssen nicht direkt aufrufen PcwUnregister . Stattdessen kompilieren sie ein Manifest mit dem CTRPP-Tool und verwenden die Funktion UnregisterXxx aus dem ctRPP-generierten Header. Die generierte Funktion sieht wie folgt aus:

EXTERN_C FORCEINLINE VOID
UnregisterMyCounterset(
    VOID
    )
{
    PAGED_CODE();

    PcwUnregister(MyCounterset);
}

Die von CTRPP generierte Unregister-Funktion heißt PrefixUnregisterCounterSet. Das Präfix ist normalerweise leer, kann aber vorhanden sein, wenn der -prefix Parameter in der CTRPP-Befehlszeile verwendet wurde. CounterSet ist der Name des Countersets, wie im Manifest angegeben. Beachten Sie, dass die Funktion auf eine Counterset-Variable (MyCounterset im Beispiel) verweist, bei der es sich um eine globale Variable handelt, die das Von der CTRPP-generierten RegisterXxx-Funktion initialisierte Gegensetregistrierungshandle enthält.

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

PcwRegister-Funktion