Función KsReferenceBusObject (ks.h)

Hace referencia al objeto de dispositivo físico de bus.

Sintaxis

KSDDKAPI NTSTATUS KsReferenceBusObject(
  [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

Devuelve STATUS_SUCCESS si la referencia se realizó correctamente; de lo contrario, devuelve un error como STATUS_INSUFFICIENT_RESOURCES.

Comentarios

Los filtros que usan el encabezado del dispositivo usan esta función para realizar un seguimiento de su pila de objetos PnP. Normalmente, se llama a en un open correcto del filtro cuando el bus de este dispositivo requiere una referencia de este tipo (como dispositivos de software) y coincide con una llamada a KsDereferenceBusObject en un cierre de esa 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. Si no se ha hecho referencia previamente al objeto, se asigna espacio de interfaz y la función usa el objeto de dispositivo PnP para adquirir la interfaz de referencia de bus. A continuación, llama al método ReferenceDeviceObject en esa interfaz. 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