Función KsSetTargetDeviceObject (ks.h)

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

Ninguno

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 KsRecalculateStackDepthy el encabezado del dispositivo se usa cuando el objeto reenvía IRP a través de una conexión a otro dispositivo y necesita 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 volver a calcular la profundidad de la pila.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	ks.h (incluya Ks.h)
biblioteca de	Ks.lib

Consulte también

KsAllocateDeviceHeader

KsAllocateObjectHeader

KsRecalculateStackDepth

KsSetDevicePnpAndBaseObject