PFNKSDEVICECREATE-Rückruffunktion (ks.h)
Die AVStrMiniDeviceAdd-Routine eines AVStream-Minitreibers benachrichtigt den Minitreiber, 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 funktionale Geräteobjekt (Functional Device Object, FDO) beschreibt, das gerade erstellt wurde.
Rückgabewert
Sollte STATUS_SUCCESS oder den Fehlercode zurückgeben, der vom Versuch zurückgegeben wurde, den Vorgang auszuführen. Wenn der Minidriver einen Fehler status zurückgibt, schlägt auch der zugehörige AddDevice-Aufruf fehl. Weitere Informationen finden Sie weiter unten im Abschnitt "Hinweise".
Hinweise
Der Minidriver gibt die Adresse dieser Routine im Element Hinzufügen der KSDEVICE_DISPATCH-Struktur an.
AVStream ruft AVStrMiniDeviceAdd aus seiner Standardmäßigen AddDevice-Routine zur KSDEVICE-Initialisierungszeit auf. An dem Punkt, an dem diese Routine aufgerufen wird, wurde das WDM-Geräteobjekt (DEVICE_OBJECT) erstellt, die KSDEVICE-Struktur instanziiert und initialisiert, und der KS-Geräteheader wurde zugeordnet.
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 status Code zurückgibt, schlägt die AddDevice-Routine von AVStream fehl. STATUS_PENDING ist kein gesetzlicher Rückgabecode, da kein IRP beteiligt ist. Die Routine wird nur unter IRQL = PASSIVE_LEVEL aufgerufen.
Diese Routine ist optional.
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 | Desktop |
| Kopfzeile | ks.h (ks.h einschließen) |
| IRQL | PASSIVE_LEVEL (siehe Abschnitt "Hinweise") |