Función PcwUnregister (wdm.h)

  • Artículo

La PcwUnregister función cierra el registro del conjunto de contadores especificado. La mayoría de los desarrolladores usarán una función UnregisterXxx generada por CTRPP en lugar de llamar directamente a esta función.

Sintaxis

void PcwUnregister(
  PPCW_REGISTRATION Registration
);

Parámetros

Registration

[en un puntero al registro que se está cerrando.

Valor devuelto

None

Observaciones

La PcwUnregister función cierra el registro del conjunto de contadores especificado. Las instancias que pertenecen al registro del conjunto de contadores se cierran automáticamente. El proveedor no debe tener acceso a estas instancias mientras se anula el registro del conjunto de contadores o después de que se anule el registro del conjunto de contadores.

Antes de que el proveedor use esta función, el proveedor debe llamar a la función PcwRegister para crear un registro.

Función UnregisterXxx generada por CTRPP

La mayoría de los desarrolladores no necesitan llamar PcwUnregister directamente. En su lugar, compilarán un manifiesto con la herramienta CTRPP y usarán la función UnregisterXxx desde el encabezado generado por CTRPP. La función generada tendrá este aspecto:

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

    PcwUnregister(MyCounterset);
}

La función Unregister generada por CTRPP se denominará PrefixUnregisterCounterSet. El prefijo suele estar en blanco, pero puede estar presente si el -prefix parámetro se usó en la línea de comandos de CTRPP. CounterSet es el nombre del conjunto de contadores, como se especifica en el manifiesto. Tenga en cuenta que la función hace referencia a una variable Counterset (MyCounterset en el ejemplo), que es una variable global que contiene el identificador de registro del conjunto de contadores inicializado por la función RegisterXxx generada por CTRPP.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows 7 y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL IRQL <= APC_LEVEL

Consulte también

Función PcwRegister