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. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. 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 den 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 resource-list-Objekt, das die rohen Hardwareressourcen identifiziert, die der Plug & 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 & 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 OnPrepareHardware zugewiesen wurden. Da OnReleaseHardware Ressourcen für Erfolgs- und Fehlerfälle von OnPrepareHardware freigeben muss, muss OnReleaseHardware in der Lage sein, die Bereinigung von Teilressourcen zu verarbeiten.
Hinweise
Die IPnpCallbackHardware2::OnPrepareHardware-Methode unterscheidet sich von der IPnpCallbackHardware::OnPrepareHardware-Methode dadurch, dass 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 |
| UMDF-Mindestversion | 1.11 |
| Kopfzeile | wudfddi.h |