WDF_CHILD_RETRIEVE_INFO 構造体 (wdfchildlist.h)

[アーティクル]
02/26/2024

[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 を呼び出している場合、このポインターは使用されません。