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

Weitere Informationen

IPnpCallbackHardware2

OnReleaseHardware