Función KsSetTargetDeviceObject (ks.h)

Artículo
03/05/2024

La función KsSetTargetDeviceObject establece el objeto de dispositivo de destino de un objeto . La función agrega el encabezado de objeto a una lista de encabezados de objeto que tienen dispositivos de destino.

Sintaxis

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

Parámetros

[in] Header

Apunta a un encabezado asignado previamente por KsAllocateObjectHeader.

[in, optional] TargetDevice

Opcionalmente, contiene el objeto de dispositivo de destino que se usará al recalcular la profundidad de la pila para el objeto de dispositivo subyacente. Si el valor es NULL, se quita cualquier configuración actual. Si el valor es cualquier valor distinto de NULL, se reemplaza la configuración actual.

Valor devuelto

None

Observaciones

La función KsSetTargetDeviceObject supone que el autor de la llamada ha asignado previamente un encabezado de dispositivo en el objeto de dispositivo subyacente con la función KsAllocateDeviceHeader . La presencia del encabezado del dispositivo permite futuras llamadas a la función KsRecalculateStackDepth y el encabezado del dispositivo se usa cuando el objeto reenvíe los IRP a través de una conexión a otro dispositivo y debe realizar un seguimiento de la profundidad de la pila.

Si KsSetDevicePnpAndBaseObject también se usa para asignar la pila de objetos PnP, ese objeto de dispositivo también se tendrá en cuenta al recalcular la profundidad de la pila.