Compartir a través de


Función PcwCloseInstance (wdm.h)

La PcwCloseInstance función cierra una instancia de conjunto de contadores que se creó mediante PcwCreateInstance. La mayoría de los desarrolladores usarán una función CloseXxx generada por CTRPP en lugar de llamar a esta función directamente.

Sintaxis

void PcwCloseInstance(
  [in] PPCW_INSTANCE Instance
);

Parámetros

[in] Instance

Puntero a la instancia del conjunto de contadores que se va a cerrar.

Valor devuelto

None

Observaciones

Use la PcwCreateInstance función para crear una instancia de conjunto de contadores.

No puede llamar a PcwCloseInstance en una instancia si ya ha llamado a PcwUnregister para el registro de conjunto de contadores correspondiente. Al anular el registro del conjunto de contadores, las instancias restantes se cierran automáticamente. Cerrarlos de nuevo bloqueará el sistema.

Función CloseXxx generada por CTRPP

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

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

    PcwCloseInstance(Instance);
}

La función Close generada por CTRPP se denominará PrefixCloseCounterSet. El prefijo suele estar en blanco, pero puede estar presente si el -prefix parámetro se usó en la línea de comandos CTRPP. CounterSet es el nombre del conjunto de contadores, como se especifica en el manifiesto.

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 PcwCreateInstance