Função KsSetTargetDeviceObject (ks.h)

Artigo
02/26/2024

A função KsSetTargetDeviceObject define o objeto de dispositivo de destino de um objeto . A função adiciona o cabeçalho do objeto a uma lista de cabeçalhos de objeto que têm dispositivos de destino.

Sintaxe

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

Parâmetros

[in] Header

Aponta para um cabeçalho alocado anteriormente por KsAllocateObjectHeader.

[in, optional] TargetDevice

Opcionalmente, contém o objeto de dispositivo de destino que será usado ao recalcular a profundidade da pilha para o objeto de dispositivo subjacente. Se o valor for NULL, qualquer configuração atual será removida. Se o valor for qualquer configuração diferente de NULL, a configuração atual será substituída.

Retornar valor

Nenhum

Comentários

A função KsSetTargetDeviceObject pressupõe que o chamador tenha alocado anteriormente um cabeçalho de dispositivo no objeto de dispositivo subjacente com a função KsAllocateDeviceHeader . A presença do cabeçalho do dispositivo permite chamadas futuras para a função KsRecalculateStackDepth e o cabeçalho do dispositivo é usado quando o objeto encaminha IRPs por meio de uma conexão com outro dispositivo e precisa controlar a profundidade da pilha.

Se KsSetDevicePnpAndBaseObject também for usado para atribuir a pilha de objetos PnP, esse objeto de dispositivo também será levado em conta ao recalcular a profundidade da pilha.