PFNKSDEVICECREATE-Rückruffunktion (ks.h)

Die AVStrMiniDeviceAdd Routine von AVStream minidriver benachrichtigt den Minidriver, dass die PnP-AddDevice Routine von AVStream abgeschlossen wurde.

Syntax

PFNKSDEVICECREATE Pfnksdevicecreate;

NTSTATUS Pfnksdevicecreate(
  [in] PKSDEVICE Device
)
{...}

Parameter

[in] Device

Zeiger auf eine KSDEVICE- Struktur, die das gerade erstellte funktionale Geräteobjekt (FDO) beschreibt.

Rückgabewert

Sollte STATUS_SUCCESS oder den Fehlercode zurückgeben, der vom Versuch zum Ausführen des Vorgangs zurückgegeben wurde. Wenn der Minidriver den Fehlerstatus zurückgibt, schlägt auch der zugehörige AddDevice Aufruf fehl. Weitere Informationen finden Sie im Abschnitt "Hinweise" weiter unten.

Bemerkungen

Der Minidriver gibt die Adresse dieser Routine im Mitglied der KSDEVICE_DISPATCH Struktur hinzufügen an.

AVStream ruft AVStrMiniDeviceAdd aus der Standardroutine AddDevice an, wobei KSDEVICE Initialisierungszeit verwendet wird. An der Stelle, an der diese Routine aufgerufen wird, wurde das WDM-Geräteobjekt (DEVICE_OBJECT) erstellt, die KSDEVICE- Struktur instanziiert und initialisiert, und der KS-Geräteheader wurde zugewiesen.

Minidriver können diese Routine verwenden, um Kontextinformationen dem AVStream-Geräteobjekt zuzuordnen oder eine Geräteerweiterung zu initialisieren.

Wenn diese Routine einen nicht erfolgreichen Statuscode zurückgibt, schlägt die AddDevice Routine von AVStream fehl. STATUS_PENDING ist kein rechtlicher Rückgabecode, da keine IRP beteiligt ist. Die Routine wird nur bei IRQL = PASSIVE_LEVEL aufgerufen.

Diese Routine ist optional.

Anforderungen

Siehe auch

KSDEVICE_DISPATCH