WdfPdoUpdateAddressDescription 関数 (wdfpdo.h)

  • [アーティクル]

[KMDF にのみ適用]

WdfPdoUpdateAddressDescription メソッドは、指定されたフレームワーク デバイス オブジェクトに関連付けられているアドレスの説明を更新します。

構文

NTSTATUS WdfPdoUpdateAddressDescription(
  [in]      WDFDEVICE                             Device,
  [in, out] PWDF_CHILD_ADDRESS_DESCRIPTION_HEADER AddressDescription
);

パラメーター

[in] Device

デバイスの物理デバイス オブジェクト (PDO) を表すフレームワーク デバイス オブジェクトへのハンドル。

[in, out] AddressDescription

アドレスの説明を含む呼び出し元によって割り当てられたバッファーへのポインター。 アドレスの説明には 、WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 構造体が含まれている必要があります。

戻り値

操作が成功した場合、関数はSTATUS_SUCCESSを返します。 その他の戻り値は次のとおりです。

リターン コード 説明
STATUS_INVALID_PARAMETER
 デバイス ハンドルは PDO を表しません。
STATUS_INVALID_DEVICE_REQUEST
 デバイス ハンドルは、動的に列挙されたデバイスを表しません。または、指定したWDF_CHILD_ADDRESS_DESCRIPTION_HEADER構造体の Size メンバーが、デバイスの既存のアドレスの説明のサイズと一致しない場合は。
 

メソッドは、他の NTSTATUS 値も返す場合があります。

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

要件

要件 値
対象プラットフォーム ユニバーサル
最小 KMDF バージョン 1.0
Header wdfpdo.h (Wdf.h を含む)
Library Wdf01000.sys (「Framework ライブラリのバージョン管理」を参照)。
IRQL <= DISPATCH_LEVEL
DDI コンプライアンス規則 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

こちらもご覧ください

WdfPdoRetrieveAddressDescription