KsGetMultiplePinFactoryItems, fonction (ksproxy.h)

Article
03/05/2024

La fonction KsGetMultiplePinFactoryItems récupère les éléments de propriété d’épingle dans une mémoire tampon de données de longueur variable.

Syntaxe

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

Paramètres

[in] FilterHandle

Gérez le filtre qui contient la fabrique d’épingles à interroger.

[in] PinFactoryId

Identificateur de la fabrique d’épingles sur laquelle les éléments de propriété sont retournés.

[in] PropertyId

Identificateur de la propriété dans le jeu de propriétés pin (KSPROPSETID_Pin) à interroger.

[out] Items

Pointeur vers une mémoire tampon pour recevoir les éléments de propriété. S’il est récupéré avec succès, ce pointeur doit être supprimé par la suite avec la fonction CoTaskMemFree .

Valeur retournée

Retourne NOERROR en cas de réussite ; sinon, retourne un code d’erreur.

Remarques

La fonction KsGetMultiplePinFactoryItems interroge la taille des données, en octets, de la propriété demandée, alloue une mémoire tampon et récupère les données.

Pour plus d’informations sur CoTaskMemFree, consultez la documentation Microsoft Windows SDK.