Função KsReferenceBusObject (ks.h)

Faz referência ao objeto de dispositivo físico do barramento.

Sintaxe

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

Retornar valor

Retorna STATUS_SUCCESS se a referência tiver sido bem-sucedida, caso contrário, um erro como STATUS_INSUFFICIENT_RESOURCES.

Comentários

Essa função é usada por filtros que usam o cabeçalho do dispositivo para acompanhar a pilha de objetos PnP. Normalmente, isso é chamado em um Open do filtro bem-sucedido quando o barramento desse dispositivo requer essa referência (como dispositivos de software) e é correspondido por uma chamada a KsDereferenceBusObject em um fechamento dessa 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. Se o objeto não tiver sido referenciado anteriormente, o espaço de interface será alocado e a função usará o objeto de dispositivo PnP para adquirir a interface de referência do barramento. Em seguida, ele chama o método ReferenceDeviceObject nessa interface. A interface em si é liberada e liberada quando o cabeçalho do dispositivo é liberado.

Requisitos