Función KsGetMultiplePinFactoryItems (ksproxy.h)

Artículo
02/29/2024

La función KsGetMultiplePinFactoryItems recupera elementos de propiedad pin en un búfer de datos de longitud variable.

Sintaxis

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

Parámetros

[in] FilterHandle

Control para el filtro que contiene el generador de patillas que se va a consultar.

[in] PinFactoryId

Identificador del generador de patillas en el que se devuelven los elementos de propiedad.

[in] PropertyId

Identificador de la propiedad del conjunto de propiedades pin (KSPROPSETID_Pin) que se va a consultar.

[out] Items

Puntero a un búfer para recibir los elementos de propiedad. Si se recupera correctamente, este puntero se debe eliminar posteriormente con la función CoTaskMemFree .

Valor devuelto

Devuelve NOERROR si se ejecuta correctamente; de lo contrario, devuelve un código de error.

Comentarios

La función KsGetMultiplePinFactoryItems consulta el tamaño de los datos, en bytes, de la propiedad solicitada, asigna un búfer y recupera los datos.

Para obtener más información sobre CoTaskMemFree, consulte la documentación de Microsoft Windows SDK.