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 |