Condividi tramite

Funzione KsAddObjectCreateItemToDeviceHeader (ks.h)

  • Articolo

La funzione KsAddObjectCreateItemToDeviceHeader aggiunge l'elemento create-item specificato a un elemento vuoto nell'elenco di elementi di creazione precedentemente allocati per questa intestazione del dispositivo. Un elemento vuoto è indicato da un NULL creare una funzione dispatch nella voce. Questa funzione presuppone che il chiamante serializzi più modifiche all'elenco di elementi di creazione.

Sintassi

KSDDKAPI NTSTATUS KsAddObjectCreateItemToDeviceHeader(
  [in]           KSDEVICE_HEADER      Header,
  [in]           PDRIVER_DISPATCH     Create,
  [in]           PVOID                Context,
  [in]           PWSTR                ObjectClass,
  [in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor
);

Parametri

[in] Header

Punta all'intestazione del dispositivo che contiene la tabella di creazione figlio allocata in precedenza.

[in] Create

Specifica la funzione di creazione dispatch.

[in] Context

Specifica il parametro di contesto.

[in] ObjectClass

Specifica un puntatore a un NULLstringa di caratteri con terminazione che verrà usata per il confronto per le richieste di creazione. Questo puntatore deve rimanere valido mentre l'oggetto dispositivo è attivo.

[in, optional] SecurityDescriptor

Specifica il descrittore di sicurezza. Questa operazione deve rimanere valida mentre l'oggetto dispositivo è attivo. Questo parametro è facoltativo.

Valore restituito

La funzione KsAddObjectCreateItemToDeviceHeader restituisce STATUS_SUCCESS se è stato trovato uno slot di elementi di creazione vuoto e l'elemento è stato aggiunto. In caso di esito negativo, restituisce STATUS_ALLOTTED_SPACE_EXCEEDED.

Fabbisogno

Requisito Valore
piattaforma di destinazione Universale
intestazione ks.h (include Ks.h)
libreria Ks.lib