Funzione KsDereferenceBusObject (ks.h)

Articolo
02/07/2025

Dereferenzia l'oggetto dispositivo fisico del bus.

Sintassi

KSDDKAPI VOID KsDereferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

Parametri

[in] Header

Punta a un'intestazione allocata in precedenza da KsAllocateDeviceHeader che contiene anche l'oggetto stack di dispositivi PnP.

Valore restituito

Nessuno.

Osservazioni

Viene usato dai filtri che usano l'intestazione del dispositivo per tenere traccia dello stack di oggetti PnP corrispondente. Questo viene in genere chiamato quando si chiude un filtro, se richiesto dal bus per il dispositivo specificato. Ad esempio, un dispositivo software richiederebbe una chiamata di questo tipo. Questa chiamata corrisponde a una chiamata precedente a KsReferenceBusObject all'apertura dell'istanza del filtro. Il chiamante deve aver chiamato in precedenza anche KsSetDevicePnpAndBaseObject per impostare l'oggetto stack di dispositivi PnP. Questa operazione sarebbe stata eseguita nella funzione PnP AddDevice. La funzione chiama il metodo DereferenceDeviceObject sull'interfaccia recuperata in precedenza. L'interfaccia stessa viene rilasciata e liberata quando l'intestazione del dispositivo viene liberata.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
intestazione	ks.h (include Ks.h)
libreria	Ks.lib

Condividi tramite