Freigeben über


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

Siehe auch

IPnpCallbackHardware2

OnReleaseHardware-