IOCTL_KS_PROPERTY IOCTL (ks.h)
アプリケーションでは、IOCTL_KS_PROPERTYを使用してプロパティを取得または設定したり、KS オブジェクトでサポートされるプロパティを特定したりできます。 アプリケーションは、以下で説明するパラメーターを持つIOCTL_KS_PROPERTYを KsSynchronousDeviceControl 関数に渡します。
メジャー コード
入力バッファー
InBuffer パラメーター クライアント指定の内容は、プロパティ要求によって異なり、各プロパティ セットについて文書化されています。 たとえば、KSPROPSETID_Pin プロパティ セット内のプロパティを要求するクライアントは、KSP_PIN 構造体へのポインターを指定します。
入力バッファーの長さ
アプリケーションは、入力バッファーの内容のサイズ (バイト単位) を InLength パラメーターに配置します。
出力バッファー
同様に、必要な出力バッファーの種類もプロパティ要求によって異なります。
出力バッファーの長さ
アプリケーションは、出力バッファーのサイズ (バイト単位) を OutLength パラメーターに配置します。
状態ブロック
要求が成功した場合、Status メンバーはSTATUS_SUCCESSに設定されます。
備考
入力バッファーと出力バッファーとそのサイズの詳細については、「KS プロパティ」を参照してください。
フィルターとピンは、IOCTL_KS_PROPERTY デバイス I/O コントロールを使用してプロパティ セットをサポートします。 この IOCTL は METHOD_NEITHER フラグで定義されていますが、プロパティ データは出力バッファーとして IOCTL に渡され、読み取りアクセス用にプローブされます。 KsPropertyHandler 関数は、IOCTL_KS_PROPERTYを介して要求されたプロパティを処理します。
有効なフラグと対応する説明の一覧については、KSPROPERTY 構造体のリファレンス ページを参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ヘッダー | ks.h (Ks.h を含む) |
関連項目
KSPROPERTY を する