Função KsPinPropertyHandler (ks.h)

Artigo
02/07/2025

A função KsPinPropertyHandler executa o tratamento padrão dos membros estáticos do conjunto de propriedades KSPROPSETID_Pin. Esse tratamento não inclui KSPROPERTY_PIN_CINSTANCES ou KSPROPERTY_PIN_DATAINTERSECTION.

Sintaxe

KSDDKAPI NTSTATUS KsPinPropertyHandler(
  [in]      PIRP                   Irp,
  [in]      PKSPROPERTY            Property,
  [in, out] PVOID                  Data,
  [in]      ULONG                  DescriptorsCount,
  [in]      const KSPIN_DESCRIPTOR *Descriptor
);

Parâmetros

[in] Irp

Especifica o IRP que está tratando a solicitação de conexão.

[in] Property

Especifica as informações de propriedade específicas.

[in, out] Data

Especifica o parâmetro de dados mapeado para um endereço do sistema. Esse é o mesmo parâmetro passado para um manipulador de propriedades por meio de um KsPropertyHandler retorno de chamada.

[in] DescriptorsCount

Especifica o número de descritores de pin que estão sendo passados.

[in] Descriptor

Especifica o ponteiro para a lista de descritores de pino.

Valor de retorno

A função KsPinPropertyHandler retorna STATUS_SUCCESS ou um erro específico à propriedade que está sendo tratada. A função preenche o IO_STATUS_BLOCK. Campo de informações do PIRP. Elemento IoStatus dentro do IRP. Ele não define o IO_STATUS_BLOCK. Campo status nem concluir o IRP.

Observações

Não use a função KsPinPropertyHandler para definir um conjunto de propriedades de pin; um conjunto de propriedades de pin pode ser definido com mais facilidade usando a macro DEFINE_KSPROPERY_PINSET.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
cabeçalho	ks.h (incluir Ks.h)
biblioteca	Ks.lib

Partilhar via