KsPinPropertyHandler-Funktion (ks.h)

Artikel
02/07/2025

Die KsPinPropertyHandler--Funktion führt die Standardbehandlung der statischen MemberKSPROPSETID_Pin Eigenschaftensatzes durch. Diese Behandlung enthält nicht KSPROPERTY_PIN_CINSTANCES oder KSPROPERTY_PIN_DATAINTERSECTION.

Syntax

KSDDKAPI NTSTATUS KsPinPropertyHandler(
  [in]      PIRP                   Irp,
  [in]      PKSPROPERTY            Property,
  [in, out] PVOID                  Data,
  [in]      ULONG                  DescriptorsCount,
  [in]      const KSPIN_DESCRIPTOR *Descriptor
);

Parameter

[in] Irp

Gibt den IRP an, der die Verbindungsanforderung verarbeitet.

[in] Property

Gibt die spezifischen Eigenschafteninformationen an.

[in, out] Data

Gibt den Datenparameter an, der einer Systemadresse zugeordnet ist. Dies ist derselbe Parameter, der über einen KsPropertyHandler Rückruf an einen Eigenschaftenhandler übergeben wird.

[in] DescriptorsCount

Gibt die Anzahl der übergebenen Pindeskriptoren an.

[in] Descriptor

Gibt den Zeiger auf die Liste der Pindeskriptoren an.

Rückgabewert

Die KsPinPropertyHandler--Funktion gibt STATUS_SUCCESS oder einen Fehler zurück, der für die behandelte Eigenschaft spezifisch ist. Die Funktion füllt die IO_STATUS_BLOCK aus. Informationsfeld des PIRP. IoStatus-Element innerhalb des IRP. Die IO_STATUS_BLOCK wird nicht festgelegt. Statusfeld oder Abschließen des IRP.

Bemerkungen

Verwenden Sie nicht die KsPinPropertyHandler--Funktion, um einen Pin-Eigenschaftensatz zu definieren; Ein Pin-Eigenschaftensatz kann mithilfe des DEFINE_KSPROPERY_PINSET Makros einfacher definiert werden.

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	ks.h (enthalten Ks.h)
Library	Ks.lib

Freigeben über