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 は、要素の数と型、およびそれがサポートする機能を含む、チェンジャーのパラメーターを返します。
ChangerGetParameters を呼び出す前に、changer クラス ドライバーは I/O スタックの場所で出力バッファーの長さを確認。 出力バッファーの長さが sizeof(GET_CHANGER_PARAMETERS) より小さい場合、チェンジャー クラス ドライバーは値が STATUS_INFO_LENGTH_MISMATCH で返されます。
ChangerGetParameters は、SCSI パラメーター ヘッダー ページ、要素アドレス ページ、トランスポート ジオメトリ ページ、デバイス機能ページ、またはこのデータに相当する SCSI 以外の機能ページを取得するために、CDN を使用して SRB を構築することで、デバイスからパラメーター データを取得します。
ChangerGetParameters 、Irp->AssociatedIrp.SystemBuffer にあるGET_CHANGER_PARAMETERS構造体を入力してから、チェンジャー クラス ドライバーに戻ります。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | mcd.h (Mcd.h、Ntddchgr.h を含む) |
| IRQL | PASSIVE_LEVEL |