Função KsDereferenceBusObject (ks.h)

Desreferencia o objeto de dispositivo físico do barramento.

Sintaxe

KSDDKAPI VOID KsDereferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

Parâmetros

[in] Header

Aponta para um cabeçalho alocado anteriormente por KsAllocateDeviceHeader que também contém o objeto de pilha de dispositivo PnP.

Valor de retorno

Nenhum.

Observações

Isso é usado por filtros que usam o cabeçalho do dispositivo para acompanhar a pilha de objetos PnP correspondente. Normalmente, isso é chamado ao fechar um filtro, se necessário pelo barramento para o dispositivo especificado. Por exemplo, um dispositivo de software exigiria essa chamada. Essa chamada corresponde a uma chamada anterior para KsReferenceBusObject ao abrir a instância de filtro. O chamador também deve ter chamado anteriormente KsSetDevicePnpAndBaseObject para definir o objeto de pilha de dispositivo PnP. Isso teria sido feito na função do PnP AddDevice. A função chama o método DereferenceDeviceObject na interface recuperada anteriormente. A interface em si é liberada e liberada quando o cabeçalho do dispositivo é liberado.

Requisitos