KsAddDevice-Funktion (ks.h)
Die KsAddDevice--Funktion ist der standardmäßige AddDevice- Handler, der von KsInitializeDriverinstalliert 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 Minidriver.
[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 Fehlerstatus von IoCreateDevice oder KsInitializeDevice.
Bemerkungen
Normalerweise ruft ein AVStream-Minidriver diese Funktion nicht direkt auf.
Weitere Informationen finden Sie unter AddDevice Routine für AVStream Minidrivers.
KsAddDevice extrahiert den in der Geräteerweiterung gespeicherten Gerätedeskriptor, der von einem Aufruf an KsInitializeDriver zugewiesen wurde, und erstellt das darin beschriebene Gerät. Wenn KsInitializeDriver- nicht zum Initialisieren des Treibers verwendet wird, erstellt diese Funktion ein Gerät mit den Standardmerkmalen und keine Filterfabriken. Der Minidriver hat immer die Möglichkeit, KsCreateDevice direkt aufzurufen, in diesem Fall wird die Treibererweiterung nicht von AVStream verwendet. Da KsAddDeviceKsCreateDeviceaufruft, sollten Treiber, die KsAddDevice aufrufen, nicht separat KsCreateDevice aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows XP und höheren Betriebssystemen und DirectX 8.0 und höher directX-Versionen. |
| Zielplattform- | Universal |
| Header- | ks.h (enthalten Ks.h) |
| Library | Ks.lib |
| IRQL- | PASSIVE_LEVEL |