StreamClassRegisterAdapter-Funktion (strmini.h)

Artikel
02/26/2024

Die StreamClassRegisterAdapter-Routine registriert einen Streamklassen-Minidriver.

Der Name StreamClassRegisterAdapter wird nur aus Gründen der Abwärtskompatibilität unterstützt.

Stattdessen empfiehlt Microsoft die Verwendung von StreamClassRegisterMinidriver, einem Alias von StreamClassRegisterAdapter. Der Name StreamClassRegisterMinidriver gibt genauer an, dass die Routine einen Streamklassen-Minidriver registriert. Nach der Registrierung kann ein Minidriver eine beliebige Anzahl von Adapterinstanzen in einem System steuern.

Die StreamClassRegisterMinidriver-Routine registriert einen Stream-Minidriver beim Streamklassentreiber.

Syntax

NTSTATUS STREAMAPI StreamClassRegisterAdapter(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] PHW_INITIALIZATION_DATA HwInitializationData
);

Parameter

[in] Argument1

Verweist auf das erste Argument auf die DriverEntry-Routine des Minitreibers.

[in] Argument2

Verweist auf das zweite Argument auf die DriverEntry-Routine des Minitreibers.

[in] HwInitializationData

Verweist auf eine HW_INITIALIZATION_DATA-Struktur , die die Informationen bereitstellt, die der Klassentreiber benötigt, um mit der Initialisierung des Minitreibers zu beginnen.

Rückgabewert

Gibt STATUS_SUCCESS bei Erfolg oder den entsprechenden Fehlercode bei Einem Fehler zurück.

Hinweise

Ein Streamminidriver muss StreamClassRegisterMinidriver innerhalb seiner DriverEntry-Routine aufrufen.

DriverEntry des Stream-Minidrivers initialisiert einen Streamklassen-Minidriver. Diese Routine ist erforderlich.

Argument1 Gibt einen Kontextwert an, mit dem der Adapter-Minidriver StreamClassRegisterMinidriver aufrufen soll. Für Windows 2000 und höher verweist dies auf eine DRIVER_OBJECT.

Argument2 Gibt einen zweiten Kontextwert an, mit dem der Adapter-Minidriver StreamClassRegisterMinidriver aufrufen soll. Für Windows 2000 und höher verweist dies auf einen Registrierungspfad.

DriverEntry gibt den Wert zurück, der durch den Aufruf von StreamClassRegisterMinidriver zurückgegeben wird.

Hinweise DriverEntry ist der erste Einstiegspunkt für einen Streamklassen-Minidriver.

Da StreamClassRegisterMinidriver den Großteil der erforderlichen Treiberinitialisierung ausführt, besteht die primäre Aufgabe der DriverEntry-Routine eines Streamklassen-Minidrivers darin, eine HW_INITIALIZATION_DATA Struktur mit treiberspezifischen Konstanten und Einstiegspunkten zuzuordnen und auszufüllen. Der DriverEntry sollte dann StreamClassRegisterMinidriver aufrufen.

Die meisten Informationen, die in der HW_INITIALIZATION_DATA-Struktur übergeben werden, informieren den Klassentreiber über die minidriverweiten Rückrufe und darüber, welche Größe Puffer für die Datenstrukturen des Minitreibers zugewiesen werden sollen. Der Klassentreiber fragt den Minidriver nach zusätzlichen Startinformationen über SRB_INITIALIZE_DEVICE und SRB_GET_STREAM_INFO Anforderungen an die StrMiniReceiveDevicePacket-Routine des Minidrivers ab (wird als HwReceivePacket-Member von HW_INITIALIZATION_DATA übergeben).

Nach der Registrierung kann ein Minidriver eine beliebige Anzahl von Adapterinstanzen in einem System steuern.