次の方法で共有


WDF_CHILD_RETRIEVE_INFO構造体 (wdfchildlist.h)

[KMDF にのみ適用]

WDF_CHILD_RETRIEVE_INFO構造体には、WdfChildListRetrieveNextDevice または WdfChildListRetrievePdoを呼び出すことによって取得された子デバイスに関する情報が含まれています。

構文

typedef struct _WDF_CHILD_RETRIEVE_INFO {
  ULONG                                                 Size;
  PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER          IdentificationDescription;
  PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER                 AddressDescription;
  WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS                 Status;
  PFN_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COMPARE EvtChildListIdentificationDescriptionCompare;
} WDF_CHILD_RETRIEVE_INFO, *PWDF_CHILD_RETRIEVE_INFO;

メンバーズ

Size

この構造体のサイズ (バイト単位)。

IdentificationDescription

ドライバーによって割り当てられた WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 構造体へのポインター。 ドライバーは、この構造体の IdentificationDescriptionSize メンバーの値を指定する必要があります。

ドライバーが WdfChildListRetrieveNextDevice 呼び出し、EvtChildListIdentificationDescriptionCompare コールバック関数を提供する場合、ドライバーは、コールバック関数が子リストのエントリと比較するために使用できる 識別 の説明も提供する必要があります。

ドライバーが WdfChildListRetrievePdo 呼び出している場合、ドライバーは ID の説明全体を入力する必要があります。

AddressDescription

ドライバーによって割り当てられた WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 構造体へのポインター。 ドライバーは、この構造体の AddressDescriptionSize メンバーの値を指定する必要があります。 フレームワークは、子リストから子を取得するときに アドレスの説明の残りの部分を入力します。 AddressDescriptionSize の値が NULL 場合、アドレスの説明情報は取得されません。

Status

フレームワークが提供する WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS型指定された値。

EvtChildListIdentificationDescriptionCompare

EvtChildListIdentificationDescriptionCompare コールバック関数へのドライバー提供のポインター。

ドライバーが WdfChildListRetrieveNextDevice 呼び出している場合、このポインターは省略可能であり、NULL できます。

ドライバーが WdfChildListRetrievePdo 呼び出している場合、このポインターは使用されません。

備考

WDF_CHILD_RETRIEVE_INFO構造体は、WdfChildListRetrieveNextDevice に渡され、WdfChildListRetrievePdo メソッド されます。

WDF_CHILD_RETRIEVE_INFO構造体を初期化するには、ドライバーは WDF_CHILD_RETRIEVE_INFO_INITを呼び出す必要があります。

必要条件

要件 価値
最小 KMDF バージョン 1.0
ヘッダー wdfchildlist.h (Wdf.h を含む)

関連項目

EvtChildListIdentificationDescriptionCompare

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS

WdfChildListRetrieveNextDevice

WdfChildListRetrievePdo