KsAddDevice-Funktion (ks.h)
Die KsAddDevice-Funktion ist der standardmäßige AddDevice-Handler , der von KsInitializeDriver installiert wird.
Syntax
KSDDKAPI NTSTATUS KsAddDevice(
[in] PDRIVER_OBJECT DriverObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject
);
Parameter
[in] DriverObject
Ein Zeiger auf das WDM-Treiberobjekt für den Minitreiber.
[in] PhysicalDeviceObject
Ein Zeiger auf das physische WDM-Geräteobjekt.
Rückgabewert
Gibt STATUS_SUCCESS zurück, der angibt, dass das Gerät erfolgreich erstellt wurde, oder ein Fehler status von IoCreateDevice oder KsInitializeDevice.
Hinweise
Normalerweise ruft ein AVStream-Minidriver diese Funktion nicht direkt auf.
Weitere Informationen finden Sie unter AddDevice Routine für AVStream Minidriver.
KsAddDevice extrahiert den Gerätedeskriptor, der in der Geräteerweiterung gespeichert ist, die aus einem Aufruf von KsInitializeDriver zugeordnet ist, und erstellt das von ihm beschriebene Gerät. Wenn KsInitializeDriver nicht zum Initialisieren des Treibers verwendet wird, erstellt diese Funktion ein Gerät mit den Standardmerkmalen und ohne Filterfactorys. Der Minidriver hat immer die Möglichkeit, KsCreateDevice direkt aufzurufen. In diesem Fall wird die Treibererweiterung nicht von AVStream verwendet. Da KsAddDeviceKsCreateDevice aufruft, sollten Treiber, die KsAddDevice aufrufen, KsCreateDevice nicht separat aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen sowie DirectX 8.0 und höher DirectX-Versionen. |
| Zielplattform | Universell |
| Header | ks.h (ks.h einschließen) |
| Bibliothek | Ks.lib |
| IRQL | PASSIVE_LEVEL |