StorPortInitializeDpc-Funktion (storport.h)

  • Artikel

Die StorPortInitializeDpc-Routine initialisiert einen StorPort-DPC.

Syntax

void StorPortInitializeDpc(
  [in]  PVOID           DeviceExtension,
  [out] PSTOR_DPC       Dpc,
  [in]  PHW_DPC_ROUTINE HwDpcRoutine
);

Parameter

[in] DeviceExtension

Zeiger auf die Geräteerweiterung pro Adapter.

[out] Dpc

Zeiger auf einen Puffer, in dem ein DPC-Objekt vom Typ STOR_DPC erstellt wird. Der Aufrufer muss sicherstellen, dass die Größe dieses Puffers in Bytes größer oder gleich sizeof(STOR_DPC) ist.

[in] HwDpcRoutine

Zeiger auf die DPC-Routine, die dem DPC-Objekt entspricht, auf das von Dpc verwiesen wird. Der Prototyp für diese verzögerte Routine ist in Storport.h wie folgt definiert:

typedef
VOID
(*PHW_DPC_ROUTINE) 
  IN PSTOR_DPC  Dpc,
  IN PVOID  HwDeviceExtension,
  IN PVOID  SystemArgument1,
  IN PVOID  SystemArgument2
  );

Rückgabewert

Keine

Bemerkungen

Die StorPortInitializeDpc-Routine muss während der HBA-Initialisierung innerhalb der HwStorPassiveInitializeRoutine-Routine des Miniporttreibers aufgerufen werden.

Diese Routine wird mithilfe von Inlinefunktionsdefinitionen implementiert, sodass Miniporttreiber, die diese Routine verwenden, keine Verknüpfungen mit Bibliotheken herstellen müssen, die von der Version des Betriebssystems abhängig sind. Miniport-Treiber können diese Routine verwenden, ohne die Abwärtskompatibilität mit Versionen des Betriebssystems zu beeinträchtigen, die KEINE DPCs in Speicher-Miniporttreibern unterstützen.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header storport.h (Storport.h einschließen)

Weitere Informationen

HwStorPassiveInitializeRoutine

STOR_DPC