Función KsDereferenceBusObject (ks.h)

Desreferencia el objeto de dispositivo físico de bus.

Sintaxis

KSDDKAPI VOID KsDereferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

Parámetros

[in] Header

Apunta a un encabezado asignado previamente por KsAllocateDeviceHeader que también contiene el objeto de pila de dispositivos PnP.

Valor devuelto

Ninguno.

Observaciones

Esto se usa mediante filtros que usan el encabezado del dispositivo para realizar un seguimiento de la pila de objetos PnP correspondiente. Normalmente se llama a esto al cerrar un filtro, si es necesario por el bus para el dispositivo determinado. Por ejemplo, un dispositivo de software requeriría dicha llamada. Esta llamada coincide con una llamada anterior a KsReferenceBusObject al abrir la instancia de filtro. El autor de la llamada debe haber llamado anteriormente también KsSetDevicePnpAndBaseObject para establecer el objeto de pila de dispositivos PnP. Esto se habría hecho en la función PnP AddDevice. La función llama al método DereferenceDeviceObject en la interfaz recuperada anteriormente. La propia interfaz se libera y libera cuando se libera el encabezado del dispositivo.

Requisitos

Requisito	Valor
de la plataforma de destino de	Universal
encabezado de	ks.h (incluya Ks.h)
biblioteca de	Ks.lib