IOCTL_KS_PROPERTY IOCTL (ks.h)

アプリケーションでは、IOCTL_KS_PROPERTYを使用してプロパティを取得または設定したり、KS オブジェクトでサポートされているプロパティを決定したりできます。 アプリケーションは、以下で説明するパラメーターを使用してIOCTL_KS_PROPERTY を KsSynchronousDeviceControl 関数に渡します。

メジャー コード

IRP_MJ_DEVICE_CONTROL

[入力バッファー]

クライアント指定の 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 構造体のリファレンス ページを参照してください。

要件

要件	値
Header	ks.h (Ks.h を含む)

こちらもご覧ください

KSPROPERTY

KSPROPERTY_DESCRIPTION

KSPROPERTY_ITEM

KSPROPERTY_MEMBERSHEADER

KSPROPERTY_SET

KSPROPERTY_VALUES