WdfChildListRequestChildEject 関数 (wdfchildlist.h)

[KMDF にのみ適用]

WdfChildListRequestChildEject メソッドは、指定したデバイスがドッキング ステーションから取り出されようとしていることをフレームワークに通知します。

構文

BOOLEAN WdfChildListRequestChildEject(
  [in] WDFCHILDLIST                                 ChildList,
  [in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);

パラメーター

[in] ChildList

子リスト オブジェクトへのハンドル。

[in] IdentificationDescription

呼び出し元によって割り当てられた WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 構造体へのポインター。

戻り値

WdfChildListRequestChildEject 、操作が成功した場合 TRUE を返します。 入力パラメーターが無効な場合、またはフレームワークが子リスト内のデバイスを見つけることができない場合、メソッドは FALSE 返します。

ドライバーが無効なオブジェクト ハンドルを提供すると、システム バグ チェックが発生します。

備考

バス ドライバーは、WdfChildListRequestChildEject 呼び出すか、WdfPdoRequestEject を して、列挙された子デバイスの 1 つをデバイスのドッキング ステーションから取り出そうとしたことがドライバーによって検出されたことを報告できます。 たとえば、ドライバーは、ユーザーがイジェクター ボタンをプッシュしたことを検出する場合があります。

ドライバーが動的バス列挙を使用していて、デバイスの識別の説明が使用可能な場合、ドライバーは WdfChildListRequestChildEjectを呼び出すことができます。 デバイスの PDO のフレームワーク デバイス オブジェクトが使用可能な場合、ドライバーは WdfPdoRequestEject 呼び出すことができます。

WdfChildListRequestChildEject メソッドの IdentificationDescription パラメーターは、取り出されるデバイスを識別します。 デバイスは、ChildList パラメーターが表す子リストのメンバーである必要があります。

フレームワークでは、識別の説明を使用して、子リスト内のデバイスを検索します。

子リストの詳細については、「動的列挙 を参照してください。

取り出し可能なデバイスの詳細については、「イジェクタブル デバイスのサポート」を参照してください。

例

WdfChildListRequestChildEjectを使用するコード例については、「WdfChildListRetrieveNextDeviceを参照してください。

必要条件

要件	価値
ターゲット プラットフォーム の	万国
最小 KMDF バージョン	1.0
ヘッダー	wdfchildlist.h (Wdf.h を含む)
ライブラリ	Wdf01000.sys (フレームワーク ライブラリのバージョン管理を参照)。
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則 を する	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

関連項目

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WdfPdoRequestEject