KsGetMultiplePinFactoryItems-Funktion (ksproxy.h)

Artikel
02/26/2024

Die KsGetMultiplePinFactoryItems-Funktion ruft Anhefteigenschaftenelemente in einem Datenpuffer mit variabler Länge ab.

Syntax

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

Parameter

[in] FilterHandle

Handle mit dem Filter, der die pin factory to query enthält.

[in] PinFactoryId

Bezeichner der Pin factory, für die die Eigenschaftselemente zurückgegeben werden.

[in] PropertyId

Bezeichner der -Eigenschaft im zu abfragenden Pin-Eigenschaftssatz (KSPROPSETID_Pin).

[out] Items

Zeiger auf einen Puffer, um die Eigenschaftselemente zu empfangen. Wenn der Zeiger erfolgreich abgerufen wurde, muss dieser Zeiger anschließend mit der Funktion CoTaskMemFree gelöscht werden.

Rückgabewert

Gibt NOERROR zurück, wenn dies erfolgreich war. Gibt andernfalls einen Fehlercode zurück.

Hinweise

Die KsGetMultiplePinFactoryItems-Funktion fragt die Datengröße der angeforderten Eigenschaft in Bytes ab, weist einen Puffer zu und ruft die Daten ab.

Weitere Informationen zu CoTaskMemFree finden Sie in der Microsoft Windows SDK-Dokumentation.