Función NtAssociateWaitCompletionPacket

Crea una asociación de finalización de espera para el objeto de destino.

Sintaxis

NTSTATUS NtAssociateWaitCompletionPacket (
    _In_ HANDLE WaitCompletionPacketHandle,
    _In_ HANDLE IoCompletionHandle,
    _In_ HANDLE TargetObjectHandle,
    _In_opt_ PVOID KeyContext,
    _In_opt_ PVOID ApcContext,
    _In_ NTSTATUS IoStatus,
    _In_ ULONG_PTR IoStatusInformation,
    _Out_opt_ PBOOLEAN AlreadySignaled
    )

Parámetros

WaitCompletionPacketHandle [in]

Identificador de un paquete de finalización de espera que describe la asociación. Este objeto no debe estar en uso.

IoCompletionHandle [in]

Identificador de un objeto de finalización de E/S que recibirá una notificación cuando se señale el objeto.

TargetObjectHandle [in]

Identificador de un objeto esperable para el que se van a recibir las notificaciones.

KeyContext [in]

Proporciona el contexto de clave que se devuelve durante una llamada a NtRemoveIoCompletion.

ApcContext [in]

Contexto apc que se devuelve durante una llamada a NtRemoveIoCompletion.

IoStatus [in]

Los datos ioStatus-Status> que se devuelven durante una llamada a NtRemoveIoCompletion.

IoStatusInformation [in]

Los datos de IoStatus-Information> que se devuelven durante una llamada a NtRemoveIoCompletion.

AlreadySignaled [out]

Puntero opcional a una variable booleana que recibe una indicación de si el objeto de destino ya se señalizó en el momento de la asociación cuando esta función se realiza correctamente.

Valor devuelto

Código NTSTATUS. Para obtener más información, vea Uso de valores NTSTATUS.

Comentarios

Cuando se señala el objeto, un paquete se pone en cola en el puerto de finalización proporcionado y los valores proporcionados se transmiten a un autor de llamada de NtRemoveIoCompletion. Cuando se recoge el paquete, la asociación debe restablecerse llamando de nuevo a esta función. Se devuelve un error si el paquete de finalización de espera ya está en uso para una asociación.

Esta función no tiene ningún archivo de encabezado o biblioteca de importación asociado; Debe llamarlo mediante las funciones LoadLibrary y GetProcAddress . La API se exporta desde ntdll.dll.

Requisitos