Función AtaPortRegistryChannelSubkeyWrite (irb.h)
La rutina AtaPortRegistryChannelSubKeyWrite escribe datos en el nombre de valor indicado en la clave HKLM\CurrentControlSet\Services\<service name>\ControllerN\ChannelM
del Registro , donde N es el número del controlador y M es el número del canal.
Sintaxis
BOOLEAN AtaPortRegistryChannelSubkeyWrite(
[in] PVOID ChannelExtension,
[in] UCHAR ControllerNumber,
[in] PCHAR ValueName,
[in] UCHAR ValueType,
[in] PUCHAR Buffer,
PULONG BufferLength
);
Parámetros
[in] ChannelExtension
Puntero a la extensión del canal.
[in] ControllerNumber
Contiene el número de controlador.
[in] ValueName
Contiene el nombre del valor del Registro en el que se va a escribir.
[in] ValueType
Indica el tipo de datos contenidos en el valor del Registro. A este miembro se le debe asignar uno de los valores indicados en la tabla siguiente.
Valor | Significado |
---|---|
IDE_REG_DWORD | Valor numérico de 4 bytes. |
IDE_REG_BINARY | Datos binarios. |
IDE_REG_SZ | Cadena Unicode terminada en null. |
[in] Buffer
Puntero al búfer de origen que contiene los datos que se van a escribir en el Registro.
BufferLength
Puntero al número de bytes de datos que se van a copiar. Si se produce un error en la operación, la ubicación a la que apunta Length se actualizará a la longitud de los datos que se escribieron correctamente en el registro.
Valor devuelto
AtaPortRegistryChannelSubKeyWrite devuelve TRUE si la operación se realiza correctamente. De lo contrario, devuelve FALSE. La rutina también devuelve FALSE si el controlador de minipuerto no lo llama de la rutina correcta.
Comentarios
Si el nombre del valor no está presente, AtaPortRegistryChannelSubKeyWrite crea una entrada para el valor y los datos se almacenan en el valor recién creado.
El búfer al que apunta Buffer debe asignarse mediante AtaPortRegistryAllocateBuffer.
El controlador de miniport debe llamar a AtaPortRegistryChannelSubKeyWrite durante la rutina AtaChannelInitRoutine o la rutina IdeHwControl El controlador de miniport no puede llamar a AtaPortRegistryChannelSubKeyWrite desde cualquier otra rutina sin devolver FALSE. Además, el controlador de miniport solo puede llamar a AtaPortRegistryChannelSubKeyWrite desde su rutina IdeHwControl si se llamó a su rutina IdeHwControl y tenía un valor de StartChannel o StopChannel en su parámetro ControlAction .
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Escritorio |
Encabezado | irb.h (incluya Ata.h, Irb.h) |
Consulte también
AtaPortRegistryChannelSubKeyRead