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.

Comentarios

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 llamador debe haber llamado previamente KsSetDevicePnpAndBaseObject para establecer el objeto de pila de dispositivos PnP. Esto se habría hecho en la función AddDevice de PnP. 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	Value
Plataforma de destino	Universal
Encabezado	ks.h (incluya Ks.h)
Library	Ks.lib