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 retornado

Nenhum.

Comentários

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 do 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 deve ter chamado anteriormente também KsSetDevicePnpAndBaseObject para definir o objeto de pilha do dispositivo PnP. Isso teria sido feito na função 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

Requisito	Valor
Plataforma de Destino	Universal
Cabeçalho	ks.h (inclua Ks.h)
Biblioteca	Ks.lib