Funzione ExCreateCallback (wdm.h)

La routine ExCreateCallback crea un nuovo oggetto callback o apre un oggetto callback esistente per conto del chiamante.

Sintassi

NTSTATUS ExCreateCallback(
  [out] PCALLBACK_OBJECT   *CallbackObject,
  [in]  POBJECT_ATTRIBUTES ObjectAttributes,
  [in]  BOOLEAN            Create,
  [in]  BOOLEAN            AllowMultipleCallbacks
);

Parametri

[out] CallbackObject

Puntatore a una posizione che riceve un puntatore a un oggetto callback, ovvero una struttura di sistema opaca. Se la chiamata ExCreateCallback ha esito positivo, la routine scrive l'indirizzo dell'oggetto callback appena creato o aperto in questa posizione. Il puntatore a oggetti callback ottenuto da questa routine può essere fornito come parametro alla routine ExRegisterCallback o ExNotifyCallback .

[in] ObjectAttributes

Puntatore a una struttura OBJECT_ATTRIBUTES contenente gli attributi dell'oggetto callback. Questa struttura è stata inizializzata in precedenza dalla routine InitializeObjectAttributes .

[in] Create

Se creare un oggetto callback. Impostare su TRUE per creare un nuovo oggetto callback se l'oggetto richiesto non può essere aperto. In caso contrario, impostare su FALSE.

[in] AllowMultipleCallbacks

Se un oggetto callback appena creato deve consentire più routine di callback registrate. Impostare su TRUE per consentire più routine di callback registrate. In caso contrario, impostare su FALSE. Questo parametro viene ignorato quando Create è FALSE o quando si apre un oggetto esistente.

Valore restituito

ExCreateCallback restituisce STATUS_SUCCESS se è stato aperto o creato un oggetto callback. In caso contrario, restituisce un codice di errore NTSTATUS per indicare la natura dell'errore.

Commenti

Un driver chiama ExCreateCallback per creare un nuovo oggetto callback o per aprire un oggetto callback esistente. Dopo aver creato o aperto l'oggetto, altri componenti possono chiamare la routine ExRegisterCallback per registrare routine di callback con l'oggetto callback.

Prima di chiamare ExCreateCallback, il driver deve chiamare InitializeObjectAttributes per inizializzare la struttura OBJECT_ATTRIBUTES per l'oggetto callback. Gli oggetti callback senza nome non sono consentiti. Il chiamante deve specificare un nome per l'oggetto; in caso contrario, la chiamata ha esito negativo con STATUS_UNSUCCESSFUL. Il chiamante deve specificare l'attributo OBJ_PERMANENT nell'oggetto callback per impedire l'eliminazione dell'oggetto prima di poter essere registrato con gestione oggetti. Il chiamante deve specificare anche qualsiasi altro attributo, ad esempio OBJ_CASE_INSENSITIVE, che potrebbe essere necessario.

Quando tutte le operazioni sono state completate con l'oggetto callback, il driver deve eliminare l'oggetto per evitare una perdita di memoria. Per informazioni sull'eliminazione di un oggetto creato con l'attributo dell'oggetto OBJ_PERMANENT, vedere ObDereferenceObject.

La tabella seguente mostra gli oggetti callback creati dal sistema operativo per l'uso da parte dei driver.

Nome dell'oggetto callback	Utilizzo
\Callback\SetSystemTime	Il sistema operativo chiama tutte le routine di callback registrate per questo oggetto ogni volta che cambia l'ora del sistema.
\Callback\PowerState	Il sistema operativo chiama tutte le routine di callback registrate per questo oggetto ogni volta che alcune caratteristiche di alimentazione del sistema cambiano. Quando un driver registra per la notifica di callback (chiamando ExRegisterCallback), può specificare le modifiche per cui deve essere notificata.

 

Per altre informazioni sugli oggetti callback, vedere Oggetti callback.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 2000.
Piattaforma di destinazione	Universale
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL
Regole di conformità DDI	HwStorPortProhibitedDDDIs(storport), IrqlExApcLte2(wdm), IrqlExPassive

Vedi anche

ExNotifyCallback

ExRegisterCallback

InitializeObjectAttributes

ObDereferenceObject