Função KsGetMultiplePinFactoryItems (ksproxy.h)

A função KsGetMultiplePinFactoryItems recupera itens de propriedade pin em um buffer de dados de comprimento variável.

Sintaxe

KSDDKAPI HRESULT KsGetMultiplePinFactoryItems(
  [in]  HANDLE FilterHandle,
  [in]  ULONG  PinFactoryId,
  [in]  ULONG  PropertyId,
  [out] PVOID  *Items
);

Parâmetros

[in] FilterHandle

Manipule para o filtro que contém a fábrica de pinos a ser consultada.

[in] PinFactoryId

Identificador da fábrica de pinos em relação ao qual os itens de propriedade estão sendo retornados.

[in] PropertyId

Identificador da propriedade no conjunto de propriedades de pin (KSPROPSETID_Pin) a ser consultado.

[out] Items

Ponteiro para um buffer para receber os itens de propriedade. Se recuperado com êxito, esse ponteiro deverá ser posteriormente excluído com a função CoTaskMemFree.

Valor de retorno

Retorna NOERROR se bem-sucedido; caso contrário, retorna um código de erro.

Observações

O KsGetMultiplePinFactoryItems consultas de função para o tamanho dos dados, em bytes, da propriedade solicitada, aloca um buffer e recupera os dados.

Para obter mais informações sobre CoTaskMemFree, consulte a documentação do SDK do Microsoft Windows.

Requisitos

Consulte também

IKsPinFactory

KSPROPERTY

KSPROPSETID_Pin

KSP_PIN