Funzione KsGetMultiplePinFactoryItems (ksproxy.h)

Articolo
02/26/2024

La funzione KsGetMultiplePinFactoryItems recupera gli elementi della proprietà pin in un buffer di dati a lunghezza variabile.

Sintassi

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

Parametri

[in] FilterHandle

Handle per il filtro che contiene la factory di pin per la query.

[in] PinFactoryId

Identificatore della factory di pin in base alla quale vengono restituiti gli elementi della proprietà.

[in] PropertyId

Identificatore della proprietà nel set di proprietà pin (KSPROPSETID_Pin) su cui eseguire la query.

[out] Items

Puntatore a un buffer per ricevere gli elementi della proprietà. Se recuperato correttamente, questo puntatore deve essere successivamente eliminato con la funzione CoTaskMemFree .

Valore restituito

Restituisce NOERROR se l'operazione riesce; in caso contrario, restituisce un codice di errore.

Commenti

La funzione KsGetMultiplePinFactoryItems esegue query per le dimensioni dei dati, in byte, della proprietà richiesta, alloca un buffer e recupera i dati.

Per altre informazioni su CoTaskMemFree, vedere la documentazione di Microsoft Windows SDK.