structure KSOBJECT_CREATE_ITEM (ks.h)
La structure KSOBJECT_CREATE_ITEM est utilisée pour rechercher la chaîne passée à une demande de création.
Syntaxe
typedef struct {
PDRIVER_DISPATCH Create;
PVOID Context;
UNICODE_STRING ObjectClass;
PSECURITY_DESCRIPTOR SecurityDescriptor;
ULONG Flags;
} KSOBJECT_CREATE_ITEM, *PKSOBJECT_CREATE_ITEM;
Membres
Create
Contient la fonction create dispatch pour cette classe d’objet de base particulière. Consultez DRIVER_OBJECT pour connaître la signature de ce type de fonction.
Context
Pointe vers une mémoire tampon qui peut être utilisée pour stocker des informations de contexte spécifiques au type d’objet. Des informations supplémentaires se trouvent dans la section Remarques ci-dessous.
ObjectClass
Pointe vers une chaîne Unicode qui identifie la classe d’objet. Il s’agit de la chaîne utilisée pour s’inscrire auprès de PnP pour une classe particulière d’objet prise en charge par cet appareil.
SecurityDescriptor
Contient un pointeur vers un SECURITY_DESCRIPTOR pour ce type d’objet, sinon NULL . Si la sécurité est utilisée, elle doit être libérée lorsque le type d’objet n’est plus utilisé. Cela doit utiliser la mémoire du pool et ne peut pas être partagée, car elle peut être remplacée. S’il est modifié, l’élément Flags est mis à jour. Optionnel.
Flags
Spécifie le type de requête. Les indicateurs peuvent avoir les valeurs répertoriées dans le tableau suivant.
| Drapeau | Description |
|---|---|
| KSCREATE_ITEM_SECURITYCHANGED | Indique que le descripteur de sécurité sur ce type d’objet a été modifié et doit être conservé. |
| KSCREATE_ITEM_WILDCARD | Indique que cet élément de création représente un caractère générique utilisé pour toutes les demandes de création qui ne correspondent à aucun autre élément de création. L’ordre de l’entrée de caractère générique dans la liste des éléments de création n’est pas pertinent. Une seule entrée de caractère générique est valide sur n’importe quelle liste d’éléments de création. |
| KSCREATE_ITEM_NOPARAMETERS | Indique que cet élément de création n’autorise pas l’exécution de paramètres et échoue si des paramètres sont trouvés. Normalement, les paramètres de création sont transmis au gestionnaire de création. Cela ne peut pas être utilisé avec un indicateur générique. |
Remarques
Un pointeur vers la structure KSOBJECT_CREATE_ITEM est placé dans le membre DriverContext de Irp->Tail.Overlay avant la création de l’objet. Vous pouvez accéder à ce pointeur à l’aide de la macro KSCREATE_ITEM_IRP_STORAGE. Cette macro et les macros associées sont incluses dans ks.h.
Le minidriver peut récupérer ce pointeur lors de la création d’un objet pour examiner le champ contexte.
Exigences
| Exigence | Valeur |
|---|---|
| d’en-tête | ks.h (include Ks.h) |