Funzione KsSetTargetDeviceObject (ks.h)

Articolo
02/07/2025

La funzione KsSetTargetDeviceObject imposta l'oggetto dispositivo di destinazione di un oggetto . La funzione aggiunge l'intestazione dell'oggetto a un elenco di intestazioni di oggetto con dispositivi di destinazione.

Sintassi

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

Parametri

[in] Header

Punta a un'intestazione allocata in precedenza da KsAllocateObjectHeader.

[in, optional] TargetDevice

Facoltativamente, contiene l'oggetto dispositivo di destinazione che verrà usato per ricalcolare la profondità dello stack per l'oggetto dispositivo sottostante. Se il valore è NULL, viene rimossa qualsiasi impostazione corrente. Se il valore è un'impostazione diversa da NULL, l'impostazione corrente viene sostituita.

Valore restituito

Nessuno

Osservazioni

La funzione KsSetTargetDeviceObject presuppone che il chiamante abbia precedentemente allocato un'intestazione del dispositivo nell'oggetto dispositivo sottostante con la funzione KsAllocateDeviceHeader. La presenza dell'intestazione del dispositivo consente chiamate future alla funzione KsRecalculateStackDepthe l'intestazione del dispositivo viene usata quando l'oggetto inoltra i runtime di integrazione tramite una connessione a un altro dispositivo e deve tenere traccia della profondità dello stack.

Se KsSetDevicePnpAndBaseObject viene usato anche per assegnare lo stack di oggetti PnP, tale oggetto dispositivo verrà preso in considerazione anche durante il ricalcolo della profondità dello stack.