Compartilhar via


Função KsSetTargetDeviceObject (ks.h)

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.

Valor de retorno

Nenhum

Observações

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 encaminhará IRPs por meio de uma conexão para outro dispositivo e precisa acompanhar 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.

Requisitos

Requisito Valor
da Plataforma de Destino Universal
cabeçalho ks.h (incluir Ks.h)
biblioteca Ks.lib

Consulte também

KsAllocateDeviceHeader

KsAllocateObjectHeader

KsRecalculateStackDepth

KsSetDevicePnpAndBaseObject