AtaPortRegistryControllerKeyWrite-Funktion (irb.h)

Artikel
02/26/2024

Die AtaPortRegistryControllerKeyWrite-Routine schreibt die Daten in den angegebenen Wertnamen unter dem Registrierungsschlüssel HKLM\CurrentControlSet\Services\<service name>\ControllerN, wobei N die Nummer des Controllers ist.

Hinweis Die Modelle ATA-Porttreiber und ATA-Miniporttreiber sind möglicherweise geändert oder in Zukunft nicht mehr verfügbar. Stattdessen wird empfohlen, die Modelle Storport-Treiber und Storport-Miniporttreiber zu verwenden.

Syntax

BOOLEAN AtaPortRegistryControllerKeyWrite(
  [in] PVOID  ChannelExtension,
  [in] UCHAR  ControllerNumber,
  [in] PCHAR  ValueName,
  [in] UCHAR  ValueType,
  [in] PUCHAR Buffer,
       PULONG BufferLength
);

Parameter

[in] ChannelExtension

Ein Zeiger auf die Kanalerweiterung.

[in] ControllerNumber

Enthält die Controllernummer.

[in] ValueName

Enthält den Namen des Registrierungswerts, in den geschrieben werden soll.

[in] ValueType

Gibt den Datentyp an, der im Registrierungswert enthalten ist. Diesem Member sollte einer der in der folgenden Tabelle angegebenen Werte zugewiesen werden.

Wert	Bedeutung
IDE_REG_DWORD	Ein numerischer Wert mit 4 Byte.
IDE_REG_BINARY	Binärdaten.
IDE_REG_SZ	Eine mit NULL endende Unicode-Zeichenfolge.

[in] Buffer

Ein Zeiger auf den Quellpuffer, der die Daten enthält, die in den Registrierungswert geschrieben werden sollen.

BufferLength

Ein Zeiger auf die Anzahl der zu kopierenden Datenbytes. Wenn der Vorgang fehlschlägt, aktualisiert der Speicherort, auf den durch Length verwiesen wird, die Länge der Daten, die erfolgreich in die Registrierung kopiert wurden.

Rückgabewert

AtaPortRegistryControllerKeyWrite gibt TRUE zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird FALSE zurückgegeben. Die Routine gibt auch FALSE zurück, wenn der Miniporttreiber ihn nicht aus der richtigen Routine aufruft.

Hinweise

Der Puffer sollte mithilfe von AtaPortRegistryAllocateBuffer zugeordnet werden.

Der Miniporttreiber muss AtaPortRegistryControllerKeyWrite während der AtaChannelInitRoutine-Routine oder der IdeHwControl-Routine aufrufen. Der Miniporttreiber kann AtaPortRegistryControllerKeyWrite nicht aus einer anderen Routine aufrufen, oder er gibt FALSE zurück. Darüber hinaus kann der Miniporttreiber AtaPortRegistryControllerKeyWrite nur aus seiner IdeHwControl-Routine aufrufen, wenn seine IdeHwControl-Routine aufgerufen wurde und den Wert StartChannel oder StopChannel im ControlAction-Parameter aufweist.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	irb.h (einschließlich Ata.h, Irb.h)

Weitere Informationen

AtaChannelInitRoutine

AtaPortRegistryAllocateBuffer

IdeHwControl

Freigeben über