WdfDeviceAllocAndQueryInterfaceProperty-Funktion (wdfdevice.h)

Artikel
02/27/2024

[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 für ein 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 typisiertes Enumerator, der den Typ des zu zuweisenden 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 ordnet. Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.

[out] PropertyMemory

Ein Zeiger auf einen WDFMEMORY-typisierten Speicherort, der ein Handle für ein Frameworkspeicherobjekt empfängt.

[out] Type

Ein Zeiger auf eine DEVPROPTYPE-typisierte Variable, die bei der Rückgabe den Typ der in PropertyMemory enthaltenen Eigenschaftendaten identifiziert.

Rückgabewert

Wenn die WdfDeviceAllocAndQueryInterfaceProperty-Methode keine Fehler aufweist, gibt sie STATUS_SUCCESS zurück. Weitere Rückgabewerte sind:

Rückgabecode	Beschreibung
STATUS_INVALID_PARAMETER	Einer der Parameter ist falsch.

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

Hinweise

Die WdfDeviceAllocAndQueryInterfaceProperty-Methode bestimmt die Menge an Arbeitsspeicher, die erforderlich ist, um die angeforderte Geräteschnittstelleneigenschaft zu speichern. Sie weist genügend Arbeitsspeicher zu, um die Daten zu speichern, und gibt ein Handle an ein Frameworkspeicherobjekt zurück, das den zugeordneten Arbeitsspeicher beschreibt. Um auf die Daten zuzugreifen, kann Ihr Treiber WdfMemoryGetBuffer aufrufen.

Informationen zu verwandten Methoden finden Sie unter Zugreifen auf das Unified Device-Eigenschaftsmodell.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8.1
Zielplattform	Universell
UMDF-Mindestversion	2.0
Kopfzeile	wdfdevice.h (einschließen von Wdf.h)
Bibliothek	WUDFx02000.lib
DLL	WUDFx02000.dll
IRQL	PASSIVE_LEVEL

Weitere Informationen

WDF_DEVICE_INTERFACE_PROPERTY_DATA

WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT

WdfDeviceAssignInterfaceProperty

WdfDeviceQueryInterfaceProperty

Freigeben über