KsCreateDevice, fonction (ks.h)
La fonction KsCreateDevice crée un appareil AVStream.
Syntaxe
KSDDKAPI NTSTATUS KsCreateDevice(
[in] PDRIVER_OBJECT DriverObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject,
[in, optional] const KSDEVICE_DESCRIPTOR *Descriptor,
[in] ULONG ExtensionSize,
[out, optional] PKSDEVICE *Device
);
Paramètres
[in] DriverObject
Pointeur vers l’objet pilote WDM du minidriver.
[in] PhysicalDeviceObject
Pointeur vers l’objet d’appareil physique WDM pour l’appareil que vous souhaitez créer sous AVStream.
[in, optional] Descriptor
Pointeur vers un descripteur d’appareil qui décrit les caractéristiques de l’appareil en cours de création. Si l’appelant ne spécifie pas ce paramètre facultatif, AVStream crée un appareil avec des caractéristiques par défaut et aucune fabrique de filtre associée.
[in] ExtensionSize
Ce paramètre contient la taille de l’extension d’appareil. S’il s’agit de zéro, la taille d’extension par défaut est utilisée. Si ce n’est pas le cas, il doit être au moins de taille (KSDEVICE_HEADER).
[out, optional] Device
Pointeur vers un emplacement de mémoire qui contient l’adresse de la structure KSDEVICE créée. Optionnel.
Valeur de retour
Retourne STATUS_SUCCESS si l’appareil est créé avec succès. Sinon, elle retourne un code d’erreur approprié.
Remarques
Normalement, le minidriver n’appelle pas cette fonction directement. Au lieu de cela, KsCreateDevice est appelé par le gestionnaire AddDevice par défaut, KsAddDevice. Étant donné que KsAddDevice effectue un appel interne à KsCreateDevice, les pilotes qui appellent KsCreateDevice ne doivent pas appeler KsAddDevice séparément.
Un minidriver qui appelle KsCreateDevice directement ne doit pas utiliser KsInitializeDriver. Si le minidriver n’appelle pas KsInitializeDriver, il doit fournir son propre AddDevice rappel. Le minidriver peut ensuite appeler KsCreateDevice à partir de ce rappel AddDevice.
Si aucune KSDEVICE_DESCRIPTOR n’est fournie, AVStream crée un appareil avec les caractéristiques par défaut et aucune fabrique de filtre associée. Si un KSDEVICE_DESCRIPTOR est fourni et contient une table KSDEVICE_DISPATCH avec une distribution de création, la distribution de création est appelée.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX. |
| plateforme cible | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |
| IRQL | PASSIVE_LEVEL |