Função PcwUnregister (wdm.h)

A PcwUnregister função fecha o registro de contraconjunto especificado. A maioria dos desenvolvedores usará uma função UnregisterXxx gerada por CTRPP em vez de chamar essa função diretamente.

Sintaxe

VOID PcwUnregister(
  PPCW_REGISTRATION Registration
);

Parâmetros

Registration

[em Um ponteiro para o registro que está sendo fechado.

Retornar valor

Nenhum

Comentários

A PcwUnregister função fecha o registro de contraconjunto especificado. As instâncias pertencentes ao registro de contador são fechadas automaticamente. Essas instâncias não devem ser acessadas pelo provedor enquanto o contador estiver sendo cancelado ou depois que o contador for cancelado.

Antes que o provedor use essa função, o provedor deve chamar a função PcwRegister para criar um registro.

Função UnregisterXxx gerada por CTRPP

A maioria dos desenvolvedores não precisa chamar PcwUnregister diretamente. Em vez disso, eles compilarão um manifesto com a ferramenta CTRPP e usarão a função UnregisterXxx do cabeçalho gerado por CTRPP. A função gerada terá esta aparência:

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

    PcwUnregister(MyCounterset);
}

A função Unregister gerada por CTRPP será denominada PrefixUnregisterCounterSet. O prefixo geralmente está em branco, mas pode estar presente se o -prefix parâmetro tiver sido usado na linha de comando CTRPP. CounterSet é o nome do contador, conforme especificado no manifesto. Observe que a função faz referência a uma variável Counterset (MyCounterset no exemplo), que é uma variável global que contém o identificador de registro de contador inicializado pela função RegisterXxx gerada por CTRPP.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows 7 e versões posteriores do Windows.
Plataforma de Destino	Universal
Cabeçalho	wdm.h (inclua Wdm.h, Ntddk.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	IRQL <= APC_LEVEL

Confira também

Função PcwRegister