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
Header	wdfchildlist.h (Wdf.h を含む)
Library	Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL	<= DISPATCH_LEVEL
DDI コンプライアンス規則	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

こちらもご覧ください

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WdfPdoRequestEject