WdfDeviceAllocAndQueryInterfaceProperty-Funktion (wdfdevice.h)

Artikel
02/07/2025

[Gilt nur für UMDF]

Die WdfDeviceAllocAndQueryInterfaceProperty Methode weist einen Puffer zu und ruft eine angegebene Geräteschnittstelleneigenschaft ab.

Syntax

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
);

Parameter

[in] Device

Ein Handle zu einem Framework-Geräteobjekt.

[in] PropertyData

Ein Zeiger auf eine WDF_DEVICE_INTERFACE_PROPERTY_DATA Struktur, die die abzurufende Geräteschnittstelleneigenschaft identifiziert.

[in] PoolType

Ein POOL_TYPE-typed-Enumerator, der den Zuteilungstyp des zuzuordnenden Arbeitsspeichers angibt.

[in, optional] PropertyMemoryAttributes

Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_OBJECT_ATTRIBUTES Struktur, die Objektattribute für das Speicherobjekt beschreibt, das die Funktion zuweist. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.

[out] PropertyMemory

Ein Zeiger auf einen WDFMEMORY--typierten Speicherort, der ein Handle für ein Framework-Speicherobjekt empfängt.

[out] Type

Ein Zeiger auf eine DEVPROPTYPE--typed-Variable, die den Typ der Eigenschaftendaten identifiziert, die in PropertyMemory-enthalten sind.

Rückgabewert

Wenn die WdfDeviceAllocAndQueryInterfaceProperty Methode keine Fehler auftritt, wird STATUS_SUCCESS zurückgegeben. Weitere Rückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	Einer der Parameter ist falsch.

Die Methode gibt möglicherweise andere NTSTATUS-Wertezurück.

Bemerkungen

Die WdfDeviceAllocAndQueryInterfaceProperty -Methode bestimmt die Menge des Arbeitsspeichers, der zum Speichern der angeforderten Geräteschnittstelleneigenschaft erforderlich ist. Es weist genügend Arbeitsspeicher zum Speichern der Daten zu und gibt ein Handle zu einem Framework-Speicherobjekt zurück, das den zugewiesenen Speicher beschreibt. Um auf die Daten zuzugreifen, kann Ihr Treiber WdfMemoryGetBuffer-aufrufen.

Informationen zu verwandten Methoden finden Sie unter Zugreifen auf das Unified Device Property Model.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 8.1
Zielplattform-	Universal
Mindest-UMDF-Version	2.0
Header-	wdfdevice.h (einschließen Wdf.h)
Library	WUDFx02000.lib
DLL-	WUDFx02000.dll
IRQL-	PASSIVE_LEVEL

Siehe auch

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAssignInterfaceProperty

WdfDeviceQueryInterfaceProperty

Freigeben über