ChangerGetParameters 関数 (mcd.h)
ChangerGetParameters は 、IOCTL コード IOCTL_CHANGER_GET_PARAMETERSを使用して、デバイス制御 IRP のデバイス固有の側面を処理します。
構文
NTSTATUS ChangerGetParameters(
[in] PDEVICE_OBJECT DeviceObject,
[in] PIRP Irp
);
パラメーター
[in] DeviceObject
チェンジャーを表すデバイス オブジェクトへのポインター。
[in] Irp
IRP へのポインター。
戻り値
ChangerGetParameters は、 システム ポート ドライバーによって返されるSTATUS_XXX 値、または次のいずれかの値を返します。
STATUS_SUCCESS
STATUS_INFO_LENGTH_MISMATCH
STATUS_INSUFFICIENT_RESOURCES
注釈
このルーチンは必須です。
ChangerGetParameters は 、要素の数と型、およびそれがサポートする機能を含む、チェンジャーのパラメーターを返します。
changer クラス ドライバーは、 ChangerGetParameters を呼び出す前に、I/O スタックの場所で出力バッファーの長さを確認します。 出力バッファーの長さが sizeof(GET_CHANGER_PARAMETERS) より小さい場合、changer クラス ドライバーは STATUS_INFO_LENGTH_MISMATCH の値でを返します。
ChangerGetParameters は、SCSI パラメーター ヘッダー ページ、要素アドレス ページ、トランスポート ジオメトリ ページ、およびデバイス機能ページ、またはこのデータと同等の非 SCSI を取得するために、CDB を使用して SRB を構築することによって、デバイスからパラメーター データを取得します。
次に、ChangerGetParametersは、changer クラス ドライバーに戻る前に、Irp-AssociatedIrp.SystemBuffer> でGET_CHANGER_PARAMETERS構造体を入力します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | mcd.h (Mcd.h、Ntddchgr.h を含む) |
| IRQL | PASSIVE_LEVEL |