AtaPortRegistryControllerKeyWrite-Funktion (irb.h)

Artikel
02/07/2025

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 Der ATA-Porttreiber und die ATA Miniport-Treibermodelle können in Zukunft geändert oder nicht verfügbar sein. Stattdessen empfehlen wir die Verwendung des Storport-Treibers und Storport Miniport Treibermodelle.

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 Element sollte einer der in der folgenden Tabelle angegebenen Werte zugewiesen werden.

Wert	Bedeutung
IDE_REG_DWORD	Ein numerischer 4-Byte-Wert.
IDE_REG_BINARY	Binäre Daten.
IDE_REG_SZ	Eine mit Null beendete 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 Daten. Wenn der Vorgang fehlschlägt, aktualisiert der Speicherort, auf den Length verweist, 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 sie nicht aus der richtigen Routine aufruft.

Bemerkungen

Der Puffer sollte mithilfe von AtaPortRegistryAllocateBufferzugewiesen werden.

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

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	irb.h (include Ata.h, Irb.h)

Siehe auch

AtaChannelInitRoutine

AtaPortRegistryAllocateBuffer

IdeHwControl-

Freigeben über