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 |