Função KsGetMultiplePinFactoryItems (ksproxy.h)
A função KsGetMultiplePinFactoryItems recupera itens de propriedade pin em um buffer de dados de comprimento variável.
KSDDKAPI HRESULT KsGetMultiplePinFactoryItems(
[in] HANDLE FilterHandle,
[in] ULONG PinFactoryId,
[in] ULONG PropertyId,
[out] PVOID *Items
);
[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.
Retorna NOERROR se bem-sucedido; caso contrário, retorna um código de erro.
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.
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | ksproxy.h (inclua Ksproxy.h) |
| biblioteca | Ksproxy.lib |