IPnpCallbackHardware2::OnPrepareHardware-Methode (wudfddi.h)
[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]
Die OnPrepareHardware--Methode führt alle Vorgänge aus, die erforderlich sind, um einen Zugriff auf ein Gerät für den Treiber zu ermöglichen.
Syntax
HRESULT OnPrepareHardware(
[in] IWDFDevice3 *pWdfDevice,
[in] IWDFCmResourceList *pWdfResourcesRaw,
[in] IWDFCmResourceList *pWdfResourcesTranslated
);
Parameter
[in] pWdfDevice
Ein Zeiger auf die IWDFDevice3 Schnittstelle für das Framework-Geräteobjekt.
[in] pWdfResourcesRaw
Ein Zeiger auf die IWDFCmResourceList Schnittstelle für das Framework-Ressourcenlistenobjekt, das die rohen Hardwareressourcen identifiziert, die der Plug- und Play-Manager dem Gerät zugewiesen hat.
[in] pWdfResourcesTranslated
Ein Zeiger auf die IWDFCmResourceList Schnittstelle für das Framework-Ressourcenlistenobjekt, das die übersetzten Hardwareressourcen identifiziert, die der Plug- und Play-Manager dem Gerät zugewiesen hat.
Rückgabewert
OnPrepareHardware gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der Fehlercodes zurück, die in Winerror.h definiert sind. Geben Sie HRESULT_FROM_NT(STATUS_NOT_SUPPORTED) nicht zurück.
Wenn OnPrepareHardware einen Fehlercode zurückgibt, ruft das Framework weiterhin die IPnpCallbackHardware2::OnReleaseHardware-Methode auf. Die OnReleaseHardware Methode kann dann Ressourcen freigeben, die während des Aufrufs von OnPrepareHardwarezugeordnet wurden. Da OnReleaseHardware Ressourcen für Erfolgs- und Fehlerfälle von OnPrepareHardware-freigeben muss, muss OnReleaseHardware in der Lage sein, die Bereinigung teilweiser Ressourcen zu verarbeiten.
Bemerkungen
Die IPnpCallbackHardware2::OnPrepareHardware Methode unterscheidet sich von der IPnpCallbackHardware::OnPrepareHardware Methode, in der sie rohe und übersetzte Ressourcen empfängt.
Informationen zum Analysieren von Hardwareressourcen finden Sie unter Suchen und Zuordnen von Hardwareressourcen in einem UMDF-Treiber-.
Beispiele
Siehe Beispielcode in IWDFDevice3::MapIoSpace.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform- | Desktop |
| Mindest-UMDF-Version | 1.11 |
| Header- | wudfddi.h |