KsDereferenceBusObject, fonction (ks.h)

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

Syntaxe

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 retournée

Aucun.

Notes

Il est utilisé par les filtres qui utilisent l’en-tête de l’appareil pour effectuer le suivi de 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écessite un tel appel. Cet appel correspond à un appel précédent à KsReferenceBusObject lors de l’ouverture du filtre instance. L’appelant doit avoir précédemment également appelé KsSetDevicePnpAndBaseObject pour définir l’objet de pile d’appareils PnP. Cela aurait été effectué dans la fonction AddDevice PnP. 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é.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib