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
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.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Universal |
| Encabezado | ks.h (incluya Ks.h) |
| Library | Ks.lib |