NDK_FN_CREATE_COMPLETION funzione di callback (ndkpi.h)

Articolo
02/07/2025

La funzione NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) completa la creazione di un oggetto NDK.

Sintassi

NDK_FN_CREATE_COMPLETION NdkFnCreateCompletion;

void NdkFnCreateCompletion(
  [in, optional] PVOID Context,
  [in]           NTSTATUS Status,
  [in]           NDK_OBJECT_HEADER *pNdkObject
)
{...}

Parametri

[in, optional] Context

Valore di contesto passato al provider NDK quando un consumer chiama una funzione di creazione di oggetti. La funzione di creazione fornisce il contesto con la richiesta di completamento della creazione asincrona puntatore di funzione NdkCreateCompletion (NDK_FN_CREATE_COMPLETION).

[in] Status

Stato di completamento asincrono per la richiesta di creazione. Vedere le funzioni di creazione dell'oggetto (ad esempio, NDK_FN_CREATE_CQ) per i codici di stato di completamento che possono essere restituiti per ogni tipo di oggetto.

[in] pNdkObject

Puntatore a un'intestazione di oggetto NDK (NDK_OBJECT_HEADER).

Valore restituito

Nessuno

Osservazioni

Nota Questa funzione viene implementata dal consumer NDK e passata al provider NDK.

Gli oggetti NDK vengono creati con funzioni asincrone. Queste funzioni di creazione di oggetti asincroni accettano un puntatore a funzione NDK_FN_CREATE_COMPLETION come parametro di input.

Un provider NDK può restituire STATUS_PENDING da una funzione di creazione di oggetti asincrona. In questo caso, il provider NDK deve chiamare la funzione di completamento di creazione per indicare che la creazione dell'oggetto è stata completata.

Qualsiasi altro codice di stato indica il completamento inline. In questo caso, il provider non deve chiamare la funzione di completamento della richiesta di creazione. Se la funzione create request restituisce un codice di stato NT_STATUS diverso da STATUS_PENDING, l'oggetto creato deve essere restituito in un parametro di output con la funzione di richiesta di creazione.

Per le richieste di creazione che restituiscono STATUS_PENDING e successive completate con STATUS_SUCCESS in modo asincrono, l'oggetto creato deve essere restituito dalla funzione di completamento di creazione con il parametro pNdkObject e il provider non deve accedere al parametro di output dell'oggetto della funzione di richiesta di creazione.

Fabbisogno

Requisito	Valore
client minimo supportato	Nessuna supportata, supportata in NDIS 6.30 e versioni successive.
server minimo supportato	Windows Server 2012
piattaforma di destinazione	Finestre
intestazione	ndkpi.h (include Ndkpi.h)
IRQL	<=DISPATCH_LEVEL