WdfDeviceAssignInterfaceProperty-Funktion (wdfdevice.h)
Wichtig
Gilt nur für UMDF
Die WdfDeviceAssignInterfaceProperty-Methode ändert den aktuellen Wert einer Geräteschnittstelleneigenschaft.
Hinweis
Zum Abrufen oder Ändern einer Geräteschnittstelleneigenschaft muss ein KMDF-Treiber IoGetDeviceInterfacePropertyData oder IoSetDeviceInterfacePropertyData direkt aufrufen.
Syntax
NTSTATUS WdfDeviceAssignInterfaceProperty(
[in] WDFDEVICE Device,
[in] PWDF_DEVICE_INTERFACE_PROPERTY_DATA PropertyData,
[in] DEVPROPTYPE Type,
[in] ULONG BufferLength,
[in, optional] PVOID PropertyBuffer
);
Parameter
[in] Device
Ein Handle für ein Framework-Geräteobjekt.
[in] PropertyData
Ein Zeiger auf WDF_DEVICE_INTERFACE_PROPERTY_DATA Struktur.
[in] Type
Ein DEVPROPTYPE-typisierter Wert, der den Typ der Daten angibt, die in PropertyBuffer bereitgestellt werden.
[in] BufferLength
Gibt die Länge des Puffers in Bytes an, auf den PropertyBuffer verweist.
[in, optional] PropertyBuffer
Ein Zeiger auf die Eigenschaftendaten der Geräteschnittstelle. Legen Sie diesen Parameter auf NULL fest, um die angegebene Eigenschaft zu löschen.
Rückgabewert
Wenn die WdfDeviceAssignInterfaceProperty-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
Informationen zu verwandten Methoden finden Sie unter Zugreifen auf das Unified Device-Eigenschaftsmodell.
Beispiele
Im folgenden Codebeispiel wird eine WDF_DEVICE_INTERFACE_PROPERTY_DATA-Struktur initialisiert und dann WdfDeviceAssignInterfaceProperty aufgerufen.
DEFINE_DEVPROPKEY(DEVPKEY_ToasterCrispLevelDword, 0x5d0ba64a, 0x2396, 0x4bc9, 0xbf, 0x49, 0x52, 0x1d, 0xa6, 0x2b, 0x1b, 0xed, 3); // DEVPROP_TYPE_UINT32
ULONG crispLevel = 0;
WDF_DEVICE_INTERFACE_PROPERTY_DATA propertyData;
WDF_DEVICE_INTERFACE_PROPERTY_DATA_INIT(
&propertyData,
&GUID_DEVINTERFACE_TOASTER_DRIVER
&DEVPKEY_ToasterCrispLevelDword
);
status = WdfDeviceAssignInterfaceProperty(device,
&propertData,
DEVPROP_TYPE_UINT32,
sizeof(crispLevel),
&crispLevel);
if (!NT_SUCCESS(status)) {
return status;
}
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für