AtaPortRegistryChannelSubkeyWrite-Funktion (irb.h)

Artikel
02/07/2025

Die AtaPortRegistryChannelSubKeyWrite Routine schreibt Daten in den angegebenen Wertnamen unter dem Registrierungsschlüssel HKLM\CurrentControlSet\Services\<service name>\ControllerN\ChannelM, wobei N die Nummer des Controllers ist und M die Nummer des Kanals 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 AtaPortRegistryChannelSubkeyWrite(
  [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 werte zugewiesen werden, die in der folgenden Tabelle angegeben sind.

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 in die Registrierung zu schreibenden Daten enthält.

BufferLength

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

Rückgabewert

AtaPortRegistryChannelSubKeyWrite 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

Wenn der Wertname nicht vorhanden ist, erstellt AtaPortRegistryChannelSubKeyWrite einen Eintrag für den Wert und die Daten werden im neu erstellten Wert gespeichert.

Der Puffer, auf den Buffer verweist, muss mithilfe AtaPortRegistryAllocateBuffer-zugewiesen werden.

Der Miniporttreiber muss AtaPortRegistryChannelSubKeyWrite- entweder während der AtaChannelInitRoutine Routine oder der IdeHwControl Routine Aufrufen des Miniporttreibers nicht AtaPortRegistryChannelSubKeyWrite von einer anderen Routine, ohne FALSEzurückzugeben. Darüber hinaus kann der Miniporttreiber nur AtaPortRegistryChannelSubKeyWrite- aus seiner IdeHwControl--Routine aufrufen, wenn die IdeHwControl Routine aufgerufen wurde und entweder StartChannel- oder StopChannel- im ControlAction Parameter aufweist.