KsPinGetConnectedPinDeviceObject-Funktion (ks.h)

Die KsPinGetConnectedPinDeviceObject-Funktion gibt das Geräteobjekt am oberen Rand des Gerätestapels zurück, das dem senkenden Pin entspricht, der an den Quellpin angefügt ist.

Syntax

KSDDKAPI PDEVICE_OBJECT KsPinGetConnectedPinDeviceObject(
  [in] PKSPIN Pin
);

Parameter

[in] Pin

Ein Zeiger auf eine KSPIN-Struktur , die der Quellpin ist, für den das Geräteobjekt des verbundenen Senkennadels abgerufen werden soll.

Rückgabewert

Wenn Pin ein Quellpin ist, gibt KsPinGetConnectedPinDeviceObject einen Zeiger auf die DEVICE_OBJECT-Struktur am oberen Rand des Gerätestapels zurück, auf dem sich der Senkennadel befindet. Andernfalls wird NULL zurückgegeben.

Hinweise

Das zurückgegebene Geräteobjekt ist nicht unbedingt das funktionale Geräteobjekt (Functional Device Object, FDO) für das Gerät, auf dem sich die Senke befindet, da möglicherweise ein Filtertreiber der oberen Ebene vorhanden ist. Es ist jedoch das Geräteobjekt, an das IOCTLs gesendet werden, die für den Senkennadel bestimmt sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher DirectX-Versionen.
Zielplattform	Universell
Header	ks.h (einschließlich Ks.h)
Bibliothek	Ks.lib

Weitere Informationen

KsGetDeviceForDeviceObject