KsPinPropertyHandler, fonction (ks.h)

Article
02/07/2025

La fonction KsPinPropertyHandler effectue une gestion standard des membres statiques de le jeu de propriétés KSPROPSETID_Pin. Cette gestion n’inclut pas KSPROPERTY_PIN_CINSTANCES ou KSPROPERTY_PIN_DATAINTERSECTION.

Syntaxe

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

Paramètres

[in] Irp

Spécifie l’IRP qui gère la demande de connexion.

[in] Property

Spécifie les informations de propriété spécifiques.

[in, out] Data

Spécifie le paramètre de données mappé à une adresse système. Il s’agit du même paramètre passé à un gestionnaire de propriétés via un rappel KsPropertyHandler.

[in] DescriptorsCount

Spécifie le nombre de descripteurs d’épingle passés.

[in] Descriptor

Spécifie le pointeur vers la liste des descripteurs d’épingle.

Valeur de retour

La fonction KsPinPropertyHandler retourne STATUS_SUCCESS ou une erreur spécifique à la propriété gérée. La fonction remplit la IO_STATUS_BLOCK. Champ d’informations du PIRP. Élément IoStatus dans l’IRP. Elle ne définit pas le IO_STATUS_BLOCK. Champ d’état ni terminer l’IRP.

Remarques

N’utilisez pas la fonction KsPinPropertyHandler pour définir un jeu de propriétés de broche ; Un jeu de propriétés pin peut être plus facilement défini à l’aide de la macro DEFINE_KSPROPERY_PINSET.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	ks.h (include Ks.h)
bibliothèque	Ks.lib

Partager via