KsGetMultiplePinFactoryItems-Funktion (ksproxy.h)

Die KsGetMultiplePinFactoryItems--Funktion ruft Pin-Eigenschaftselemente 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 to the filter that contains the pin factory to query.

[in] PinFactoryId

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

[in] PropertyId

Bezeichner der Eigenschaft im Pin-Eigenschaftensatz (KSPROPSETID_Pin) zum Abfragen.

[out] Items

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

Rückgabewert

Gibt NOERROR zurück, wenn dies erfolgreich ist; andernfalls wird ein Fehlercode zurückgegeben.

Bemerkungen

Die KsGetMultiplePinFactoryItems Funktionsabfragen für die Datengröße in Bytes der angeforderten Eigenschaft, weist einen Puffer zu und ruft die Daten ab.

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

Anforderungen

Siehe auch

IKsPinFactory-

KSPROPERTY

KSPROPSETID_Pin

KSP_PIN