次の方法で共有


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 コールバック関数を指定する場合、ドライバーは、コールバック関数が子リスト内のエントリと比較するために使用できる ID の説明 も指定する必要があります。

ドライバーが 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
Header wdfchildlist.h (Wdf.h を含む)

こちらもご覧ください

EvtChildListIdentificationDescriptionCompare

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS

WdfChildListRetrieveNextDevice

WdfChildListRetrievePdo