Compartilhar via


Função PcwCloseInstance (wdm.h)

A PcwCloseInstance função fecha uma instância de contraconjunto que foi criada usando PcwCreateInstance. A maioria dos desenvolvedores usará uma função CloseXxx gerada por CTRPP em vez de chamar essa função diretamente.

Sintaxe

void PcwCloseInstance(
  [in] PPCW_INSTANCE Instance
);

Parâmetros

[in] Instance

Um ponteiro para a instância de contraconjunto a ser fechada.

Retornar valor

Nenhum

Comentários

Use a PcwCreateInstance função para criar uma instância de contraconjunto.

Você não poderá chamar PcwCloseInstance em uma instância se já tiver chamado PcwUnregister para o registro de contador correspondente. Quando você cancela o registro do contador, todas as instâncias restantes são fechadas para você. Fechá-los novamente falhará no sistema.

Função CloseXxx gerada por CTRPP

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

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

    PcwCloseInstance(Instance);
}

A função Close gerada por CTRPP será denominada PrefixoCloseCounterSet. 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.

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 PcwCreateInstance