Função KsGetMultiplePinFactoryItems (ksproxy.h)
A função KsGetMultiplePinFactoryItems recupera itens da 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 no qual os itens de propriedade estão sendo retornados.
[in] PropertyId
Identificador da propriedade no conjunto de propriedades 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 excluído posteriormente com a função CoTaskMemFree .
Retornar valor
Retorna NOERROR se tiver êxito; caso contrário, retorna um código de erro.
Comentários
A função KsGetMultiplePinFactoryItems consulta 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
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | ksproxy.h (inclua Ksproxy.h) |
| Biblioteca | Ksproxy.lib |