IPnpCallbackHardware::OnPrepareHardware-Methode (wudfddi.h)

Artikel
03/01/2024

[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 in neueren 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 benachrichtigt einen Treiber, um den Zugriff auf die angegebene Hardware zu ermöglichen.

Syntax

HRESULT OnPrepareHardware(
  [in] IWDFDevice *pWdfDevice
);

Parameter

[in] pWdfDevice

Ein Zeiger auf die IWDFDevice-Schnittstelle für das Geräteobjekt des Geräts, auf das zugegriffen werden soll.

Rückgabewert

OnPrepareHardware gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode einen der in Winerror.h definierten Fehlercodes zurück. Geben Sie HRESULT_FROM_NT(STATUS_NOT_SUPPORTED) nicht zurück.

Wenn OnPrepareHardware einen Fehlercode zurückgibt, ruft das Framework weiterhin die IPnpCallbackHardware::OnReleaseHardware-Methode auf. Die OnReleaseHardware-Methode kann dann Ressourcen freigeben, die während des Aufrufs von OnPrepareHardware zugeordnet wurden. Da OnReleaseHardware Ressourcen für Erfolgs- und Fehlerfälle von OnPrepareHardware freigeben muss, muss es in der Lage sein, die Bereinigung von Teilressourcen zu verarbeiten.

Diese Methode muss das makro HRESULT_FROM_NT verwenden, um einen bestimmten HRESULT-Wert zurückzugeben, um status an einen Kernelmodusclient zurückzugeben. Weitere Informationen finden Sie unter Unterstützen von Kernelmodusclients.

Hinweise

Ein Treiber registriert die IPnpCallbackHardware-Schnittstelle , wenn er die IWDFDriver::CreateDevice-Methode aufruft , um ein Geräteobjekt zu erstellen.

Der Empfang eines Aufrufs der OnPrepareHardware-Methode entspricht einem WDM-Treiber (Microsoft Windows Driver Model), der eine IRP_MN_START_DEVICE IRP empfängt.

Weitere Informationen finden Sie unter Suchen und Zuordnen von Hardwareressourcen in einem UMDF-Treiber.