[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が返されます。 その他の戻り値は次のとおりです。
| リターン コード | 形容 |
|---|---|
|
パラメーターの 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 の