KsDereferenceBusObject, fonction (ks.h)

Déréférence l’objet d’appareil physique de bus.

Syntaxe

C++

KSDDKAPI VOID KsDereferenceBusObject(
  [in] KSDEVICE_HEADER Header
);

Paramètres

[in] Header

Pointe vers un en-tête précédemment alloué par KsAllocateDeviceHeader qui contient également l’objet de pile d’appareils PnP.

Valeur de retour

Aucun.

Remarques

Cela est utilisé par les filtres qui utilisent l’en-tête de l’appareil pour suivre la pile d’objets PnP correspondante. Cela est normalement appelé lors de la fermeture d’un filtre, si nécessaire par le bus pour l’appareil donné. Par exemple, un appareil logiciel nécessiterait un tel appel. Cet appel correspond à un appel précédent à KsReferenceBusObject lors de l’ouverture de l’instance de filtre. L’appelant doit avoir précédemment appelé KsSetDevicePnpAndBaseObject pour définir l’objet de pile d’appareils PnP. Cela aurait été effectué dans la fonction PnP AddDevice. La fonction appelle la méthode DereferenceDeviceObject sur l’interface précédemment récupérée. L’interface elle-même est libérée et libérée lorsque l’en-tête de l’appareil est libéré.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	ks.h (include Ks.h)
bibliothèque	Ks.lib