Función PcNewInterruptSync (portcls.h)
La función pcNewInterruptSync crea e inicializa un objeto de sincronización de interrupciones.
Sintaxis
PORTCLASSAPI NTSTATUS PcNewInterruptSync(
[out] PINTERRUPTSYNC *OutInterruptSync,
[in, optional] PUNKNOWN OuterUnknown,
[in] PRESOURCELIST ResourceList,
[in] ULONG ResourceIndex,
[in] INTERRUPTSYNCMODE Mode
);
Parámetros
[out] OutInterruptSync
Puntero de salida para el objeto de sincronización de interrupciones creado por esta función. Este parámetro apunta a una variable de puntero asignada por el llamador en la que la función genera una referencia al objeto IInterruptSync recién creado. Especifique un valor de punteroNULL válido que no sea null para este parámetro.
[in, optional] OuterUnknown
Puntero a la interfaz IUnknown de un objeto que necesita agregar el objeto. A menos que se requiera la agregación, establezca este parámetro en null.
[in] ResourceList
Puntero al objeto IResourceList que se proporcionó al controlador de miniport durante la inicialización. El controlador de puerto examinará esta lista de recursos, pero no la modificará.
[in] ResourceIndex
Especifica el índice del recurso de interrupción en la lista de recursos. Si el método IResourceList::NumberOfEntriesOfType devuelve un recuento de N para el tipo CmResourceTypeInterrupt, resourceIndex debe ser un valor en el intervalo de 0 a N-1.
[in] Mode
Especifica la forma en que se controlan varios ISR. Establezca este parámetro en uno de los valores de enumeración INTERRUPTSYNCMODE. Para obtener más información, vea la siguiente sección Comentarios.
Valor devuelto
PcNewInterruptSync devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado.
Observaciones
El parámetro Mode se establece en uno de los valores de enumeración INTERRUPTSYNCMODE de la tabla siguiente.
| Valor | Significado |
|---|---|
| InterruptSyncModeNormal | Llame a cada ISR de la lista hasta que uno de ellos devuelva STATUS_SUCCESS. |
| InterruptSyncModeAll | Llame a cada ISR de la lista exactamente una vez, independientemente de los códigos de retorno de los distintos ISR. |
| interruptSyncModeRepeat | Recorra toda la lista de ISR hasta que se produzca un recorrido por la lista en el que ningún ISR de la lista devuelva STATUS_SUCCESS. |
Para obtener descripciones detalladas de estos tres modos, vea objetos de sincronización de interrupciones.
Los parámetros de OutInterruptSync, OuterUnknowny ResourceList siguen las convenciones de recuento de referencias de para objetos COM.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 2000. |
| de la plataforma de destino de | Universal |
| encabezado de | portcls.h (incluya Portcls.h) |
| biblioteca de | Portcls.lib |
| irQL | PASSIVE_LEVEL |