KsSetTargetDeviceObject, fonction (ks.h)

Article
03/05/2024

La fonction KsSetTargetDeviceObject définit l’objet d’appareil cible d’un objet . La fonction ajoute l’en-tête d’objet à une liste d’en-têtes d’objets qui ont des appareils cibles.

Syntaxe

KSDDKAPI VOID KsSetTargetDeviceObject(
  [in]           KSOBJECT_HEADER Header,
  [in, optional] PDEVICE_OBJECT  TargetDevice
);

Paramètres

[in] Header

Pointe vers un en-tête précédemment alloué par KsAllocateObjectHeader.

[in, optional] TargetDevice

Contient éventuellement l’objet d’appareil cible qui sera utilisé lors du recalcul de la profondeur de la pile pour l’objet d’appareil sous-jacent. Si la valeur est NULL, tout paramètre actuel est supprimé. Si la valeur est un paramètre autre que NULL, le paramètre actuel est remplacé.

Valeur de retour

None

Remarques

La fonction KsSetTargetDeviceObject suppose que l’appelant a précédemment alloué un en-tête d’appareil sur l’objet d’appareil sous-jacent avec la fonction KsAllocateDeviceHeader . La présence de l’en-tête d’appareil autorise les appels ultérieurs à la fonction KsRecalculateStackDepth, et l’en-tête de l’appareil est utilisé lorsque l’objet transfère des irPs via une connexion à un autre appareil et doit effectuer le suivi de la profondeur de la pile.

Si KsSetDevicePnpAndBaseObject est également utilisé pour affecter la pile d’objets PnP, cet objet d’appareil sera également pris en compte lors du recalcul de la profondeur de la pile.