KsPinGetConnectedPinDeviceObject 関数 (ks.h)

KsPinGetConnectedPinDeviceObject 関数は、ソースピン Pin に接続されているシンクピンに対応するデバイススタックの上部にあるデバイスオブジェクトを返します。

構文

KSDDKAPI PDEVICE_OBJECT KsPinGetConnectedPinDeviceObject(
  [in] PKSPIN Pin
);

[in] Pin

接続されたシンクピンのデバイスオブジェクトを取得するソースピンである KSPIN 構造体へのポインター。

Pin がソースピンの場合、KsPinGetConnectedPinDeviceObject は、シンクピンが存在するデバイススタックの上部にあるDEVICE_OBJECT構造体へのポインターを返します。それ以外の場合は NULL を返します。

返されるデバイスオブジェクトは、シンクが存在するデバイスの機能デバイスオブジェクト (FDO) とは限りません。上位レベルのフィルタードライバーが存在する可能性があるためです。ただし、シンクピン宛ての IOCTL が送信されるデバイスオブジェクトです。

要件	値
サポートされている最小のクライアント	Microsoft Windows XP 以降のオペレーティングシステムおよび DirectX 8.0 以降の DirectX バージョンで使用できます。
対象プラットフォーム	ユニバーサル
Header	ks.h (Ks.h を含む)
Library	Ks.lib