IOCTL_KS_PROPERTY IOCTL (ks.h)

Article
08/07/2023

Une application peut utiliser IOCTL_KS_PROPERTY pour obtenir ou définir des propriétés, ou pour déterminer les propriétés prises en charge par un objet KS. L’application transmet IOCTL_KS_PROPERTY avec les paramètres décrits ci-dessous à la fonction KsSynchronousDeviceControl .

Code principal

IRP_MJ_DEVICE_CONTROL

Mémoire tampon d'entrée

Le contenu du paramètre InBuffer spécifié par le client dépend de la demande de propriété et est documenté pour chaque jeu de propriétés. Par instance, les clients qui demandent des propriétés dans le jeu de propriétés KSPROPSETID_Pin spécifient un pointeur vers une structure KSP_PIN.

Longueur de la mémoire tampon d’entrée

L’application place la taille, en octets, du contenu de la mémoire tampon d’entrée dans le paramètre InLength .

Mémoire tampon de sortie

De même, le type de mémoire tampon de sortie requis dépend également de la demande de propriété.

Longueur de la mémoire tampon de sortie

L’application place la taille, en octets, de la mémoire tampon de sortie dans le paramètre OutLength .

Bloc d’état

Si la demande réussit, le membre Status est défini sur STATUS_SUCCESS.

Remarques

Pour plus d’informations sur les mémoires tampons d’entrée et de sortie et leurs tailles, consultez Propriétés KS.

Les filtres et les broches prennent en charge les jeux de propriétés à l’aide du contrôle d’E/S de l’appareil IOCTL_KS_PROPERTY . Bien que ce IOCTL soit défini avec l’indicateur METHOD_NEITHER, les données de propriété sont transmises en tant que mémoire tampon de sortie au IOCTL et sondées pour l’accès en lecture. La fonction KsPropertyHandler gère les propriétés demandées via IOCTL_KS_PROPERTY.

Pour obtenir la liste des indicateurs valides et les descriptions correspondantes, consultez la page de référence de la structure KSPROPERTY .