KsSetTargetDeviceObject-Funktion (ks.h)

Artikel
02/26/2024

Die KsSetTargetDeviceObject-Funktion legt das Zielgerätobjekt eines Objekts fest. Die Funktion fügt den Objektheader einer Liste von Objektheadern mit Zielgeräten hinzu.

Syntax

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

Parameter

[in] Header

Zeigt auf einen Header, der zuvor von KsAllocateObjectHeader zugewiesen wurde.

[in, optional] TargetDevice

Enthält optional das Zielgerätobjekt, das bei der Neuberechnung der Stapeltiefe für das zugrunde liegende Geräteobjekt verwendet wird. Wenn der Wert NULL ist, wird jede aktuelle Einstellung entfernt. Wenn der Wert eine andere Einstellung als NULL ist, wird die aktuelle Einstellung ersetzt.

Rückgabewert

Keine

Bemerkungen

Die KsSetTargetDeviceObject-Funktion geht davon aus, dass der Aufrufer dem zugrunde liegenden Geräteobjekt zuvor einen Geräteheader mit der KsAllocateDeviceHeader-Funktion zugeordnet hat. Das Vorhandensein des Geräteheaders ermöglicht zukünftige Aufrufe der Funktion KsRecalculateStackDepth, und der Geräteheader wird verwendet, wenn das Objekt IRPs über eine Verbindung mit einem anderen Gerät weiterleitet und die Stapeltiefe nachverfolgen muss.

Wenn KsSetDevicePnpAndBaseObject auch zum Zuweisen des PnP-Objektstapels verwendet wird, wird dieses Geräteobjekt auch bei der Neuberechnung der Stapeltiefe berücksichtigt.