WdfDeviceAllocAndQueryInterfaceProperty 関数 (wdfdevice.h)

[UMDF にのみ適用]

WdfDeviceAllocAndQueryInterfaceProperty メソッドは、バッファーを割り当て、指定したデバイス インターフェイス プロパティを取得します。

構文

NTSTATUS WdfDeviceAllocAndQueryInterfaceProperty(
  [in]           WDFDEVICE                           Device,
  [in]           PWDF_DEVICE_INTERFACE_PROPERTY_DATA PropertyData,
  [in]           POOL_TYPE                           PoolType,
  [in, optional] PWDF_OBJECT_ATTRIBUTES              PropertyMemoryAttributes,
  [out]          WDFMEMORY                           *PropertyMemory,
  [out]          PDEVPROPTYPE                        Type
);

パラメーター

[in] Device

フレームワーク デバイス オブジェクトへのハンドル。

[in] PropertyData

取得するデバイス インターフェイス プロパティを識別する WDF_DEVICE_INTERFACE_PROPERTY_DATA 構造体へのポインター。

[in] PoolType

割り当てるメモリの種類を指定する POOL_TYPE型指定列挙子。

[in, optional] PropertyMemoryAttributes

関数が割り当てるメモリ オブジェクトのオブジェクト属性を記述する呼び出し元によって割り当てられた WDF_OBJECT_ATTRIBUTES 構造体へのポインター。 このパラメーターは省略可能であり、WDF_NO_OBJECT_ATTRIBUTESできます。

[out] PropertyMemory

フレームワーク メモリ オブジェクトへのハンドルを受け取る WDFMEMORY型指定された場所へのポインター。

[out] Type

DEVPROPTYPE型指定された変数へのポインター。戻り値の場合、PropertyMemory に含まれるプロパティ データの型識別します。

戻り値

WdfDeviceAllocAndQueryInterfaceProperty メソッドでエラーが発生しなかった場合は、STATUS_SUCCESSが返されます。 その他の戻り値は次のとおりです。

リターン コード 形容
STATUS_INVALID_PARAMETER
 パラメーターの 1 つが正しくありません。
 

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

備考

WdfDeviceAllocAndQueryInterfaceProperty メソッドは、要求されたデバイス インターフェイス プロパティを保持するために必要なメモリの量を決定します。 データを保持するのに十分なメモリを割り当て、割り当てられたメモリを記述するフレームワーク メモリ オブジェクトにハンドルを返します。 データにアクセスするには、ドライバーは WdfMemoryGetBuffer 呼び出すことができます。

関連するメソッドの詳細については、「統合デバイス プロパティ モデルへのアクセス」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 8.1
ターゲット プラットフォーム の 万国
UMDF の最小バージョン を する 2.0
ヘッダー wdfdevice.h (Wdf.h を含む)
ライブラリ WUDFx02000.lib
DLL WUDFx02000.dll
IRQL PASSIVE_LEVEL

関連項目

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAssignInterfaceProperty の

WdfDeviceQueryInterfaceProperty の

  • 最終更新: